PATerminal documentation
Step-by-step guides for every part of PATerminal — sessions, panes, folders, AI agents, pair mode, Git, worktrees, and GitHub — from your first launch to everyday shortcuts.
Written for PATerminal v1.8.3
Start here
Getting started
Install PATerminal on macOS or Windows, accept the EULA, take the one-minute tour, and run your first agent.
A tour of the window
What each part of the PATerminal window does: the session sidebar, the toolbar, panes with their Git bar and path bar, and the quick phrase bar.
Working with AI agents
How PATerminal detects Claude Code and Codex, shows running / waiting / done status, sends notifications, and resumes conversations after a restart.
Keyboard shortcuts
Every PATerminal keyboard shortcut for macOS and Windows: sessions, panes, broadcast, Git, quick phrases, and the folder browser.
Get started
- Getting started →
Install PATerminal on macOS or Windows, accept the EULA, take the one-minute tour, and run your first agent.
- A tour of the window →
What each part of the PATerminal window does: the session sidebar, the toolbar, panes with their Git bar and path bar, and the quick phrase bar.
- Keyboard shortcuts →
Every PATerminal keyboard shortcut for macOS and Windows: sessions, panes, broadcast, Git, quick phrases, and the folder browser.
Sessions & panes
- Sessions →
Create, switch, rename, annotate, pin, color, archive, filter, and restore sessions in PATerminal's sidebar.
- Groups →
Organize PATerminal sessions into nested groups with automatic red/blue colors, drag and drop, and bulk actions.
- Panes →
Split PATerminal sessions into panes, resize, rename, restart and close them, and drop files to type their paths.
- Session split view →
Show several PATerminal sessions side by side, stacked, or in a grid, each keeping its own panes.
AI agents
- Working with AI agents →
How PATerminal detects Claude Code and Codex, shows running / waiting / done status, sends notifications, and resumes conversations after a restart.
- Conversation and prompt history →
Resume past Claude Code and Codex conversations in a new session, review every prompt you sent per session, and restore recently closed sessions.
- Pair mode →
Have two AI agents work together in PATerminal: implement × review, cross review, brainstorm, or brainstorm then build — with automatic handoffs.
- Broadcast input →
Type once in PATerminal and send the same keystrokes, quick phrases, and file paths to every pane of the sessions you choose.
- Quick phrases →
Save prompts and commands you use every day in PATerminal and insert them with one click or Cmd/Ctrl+P — globally or per repository.
Git & GitHub
- Git →
Use Git inside PATerminal: the pane bar's branch, pull, push, commit, and diff controls, plus the Git window with file status, commit graph, branches, and stash.
- Worktrees →
Give each AI agent its own checkout: create Git worktrees from a branch or pull request in PATerminal, copy ignored files like .env and node_modules, and open them as sessions.
- Pull requests and issues →
Read GitHub pull requests and review comments, create and work on issues, and start sessions or worktrees from them — inside PATerminal, using your own gh CLI.
Reference
- Settings →
Every PATerminal setting: color themes, 17 languages, notifications, updates, license, pair mode and worktree defaults, group colors, and Finder integration.
- License and trial →
How PATerminal's 30-day trial, licenses, devices, offline grace period, soft-lock, re-trial, and self-built copies work.
- Troubleshooting →
Fixes for common PATerminal problems: install warnings, Git errors, GitHub CLI, agent status, notifications, resume, and updates.