Documentation
Everything Overterm does, in the order it makes sense to learn it. Start at the top if it is new to you; the reference at the bottom is what you will come back for.
Getting started
Concepts
- Why a terminal for agentsThe problem Overterm exists for — several worktrees, an agent in each, and no way to tell which one stopped.
- Tabs and attentionWhat a tab knows about itself — its kind, whether it is working, and whether it needs you.
- IslandsTab groups that hold one checkout — named, coloured, collapsible, stashable, and never joined by accident.
- Worktrees and tasksNew Task makes a worktree, a branch and an agent in one step — and Overterm notices when the branch is merged.
Features
- Agent InboxEvery agent waiting on you in one column, with its question and its own choices as buttons.
- Panes and Tab PeekSplitting a tab, moving a pane between tabs, the header every pane carries, and seeing every tab at once.
- ChangesWhat changed in the tab's checkout, live, with the reason each file changed read from Claude's own transcripts.
- OvergitThe repository's history, graph, branches, tags, remotes, stashes and worktrees in the sidebar.
- Command paletteOne search over your command history, snippets, actions, tabs and worktrees.
- SearchOne overlay over the terminal's scrollback, the checkout's file names and their contents.
- Ask an agentHand a terminal selection to an agent in another tab, with the command it came from.
- EditorA real editor beside the terminal — tree-sitter colours, language servers, vim mode and a git gutter.
- Browser and MCPA browser column per terminal tab, and the MCP server that lets the agent in that tab drive it.
- SimulatorThe iOS simulator's live screen beside the terminal, with no Screen Recording permission involved.
- Usage and costWhat is left of each agent's quota and what the day's tokens would cost, read from files on this Mac.
- ThemesA gallery of 473 themes, applied to the terminal and the whole window without a relaunch.
- Snippets and drag and dropSaved commands with placeholders, and what happens when you drop a file on a terminal.
Reference
- Keyboard shortcutsEvery default binding, the command id behind it, and what it does.
- SettingsEvery key in settings.json, its default, what it does, and the Ghostty option it maps to.
- keybindings.jsonWhere the key map lives, and how to add, change or remove a binding by hand.
- Files on diskEverything Overterm writes, where it writes it, and what to delete to reset it.
Help
- TroubleshootingThe first-open warning, gh, the Metal toolchain, the Xcode versions that build it, and where the logs are.
- PrivacyWhat stays on this Mac, what leaves it, and why — specifically enough to check.
- VersioningHow versions are chosen, enforced by git hooks, cut into releases, and read in the changelog.