Contents

AITerm Manual

Complete searchable AITerm user manual.

Basics

1 Getting Started
AITerm is a native macOS terminal app. It opens a real shell first, then adds an AI command loop when you want help writing, fixing, or explaining…
2 Terminal Basics
AITerm is a real PTY terminal. It's a normal zsh/bash/sh/fish shell first — you can use it exactly like any terminal — and the AI input bar is an optional…
3 Updating and Uninstalling
AITerm's direct download channel uses Sparkle for app updates. You can also reinstall manually from the latest DMG. Update with Sparkle Use Check for…

4 The AI Command Loop
AITerm's core AI flow is propose → approve → run . The AI never silently runs a command it generated. It writes an editable command into the input bar and…
5 Slash Commands Reference
Slash commands are typed in the input bar and are dispatched before normal natural language classification. The canonical list below is generated from the…
6 AI Providers and Models
AITerm brings your own AI. It never proxies your requests through an AITerm server: local providers run entirely on your Mac, and cloud requests go…

7 Keyboard Shortcuts
The following shortcuts are generated from KeyboardShortcutsCatalog.swift. Tabs ⌘T New tab. ⌘⇧] Next tab. ⌘⇧[ Previous tab. ⌘1 – ⌘9 Jump to tab 1–9. Panes…
8 History and Search
AITerm has four separate tools for finding things: the command palette, the history browser, terminal scrollback search, and command mark navigation…
9 Settings Reference
Open Settings with ⌘,. It has four tabs — AI , Terminal , Security , and Privacy — plus a footer with Reset to Defaults and Apply . Apply vs. immediate…
10 Free vs. Pro
AITerm's app stays usable when you are Free. Pro unlocks the features that run longer workflows, delegate to subscription CLIs, or package security state…

11 Safety and Security
AITerm's safety model is layered. A command is assessed for risk, your active Safety Profile can tighten the result, per host floors and policy packs can…
12 Remote Commands
AITerm treats remote work as higher blast radius. SSH/mosh host profiles and transfer risk checks make production and remote machine actions visible before…
13 Privacy and Data Handling
AITerm is built to keep your data on your machine by default. There is no AITerm hosted proxy for model requests: local providers stay entirely on your…

14 Runbooks
Runbooks are Pro command sequences you can save, edit, and replay — handy for repeated project tasks that need the same commands in the same order. Every…
15 The Autonomous Agent
AITerm has two Pro agent modes for multi step tasks. Both run every command through the same security gate as everything else, and both keep you in…

16 Troubleshooting and FAQ
This page covers common states surfaced by the current app code. Local engine unreachable If Local (Ollama) cannot be reached, use Set Up AI… or the Local…