Core features · Session list

Session list (resume)

The 5th sidebar mode, "Sessions", gathers the AI CLI agent (claude · codex · agy) conversations you ran in the active project in one place and resumes them with a single click. orchterm doesn't record them separately — it reads the transcript sidecars the three CLIs leave on disk directly (parse-don't-ask).

Opening the session panel

Open it with the Sessions icon in the sidebar mode bar or Ctrl+Shift+S (the command palette's "Sessions" also works). The list is specific to the active project (current folder), so switching projects shows that project's sessions.

List — date groups · agent icons · meta

Sessions are sorted newest first and bucketed into date groups (Today / Yesterday / YYYY-MM-DD). Each row shows a brand icon that tells you which CLI it is, plus the title (first user message), a relative time, and (if any) the git branch.

① Brand icons distinguish claude·codex·agy. ② 20 at a time, then More loads +20 (instantly, no re-query).

Resume — pick up in the original folder

Click a row to resume the conversation in a new terminal tab in that session's original working folder (cwd). It runs the right command per CLI automatically.

⚠️ Resume works only if that CLI (claude · codex · antigravity) is on the system PATH.

Bypass permissions — resume without approvals

Turn on the Bypass permissions checkbox in the session panel header and resuming will automatically add each CLI's bypass-permissions flag, so the session picks up immediately without folder-trust or tool-approval prompts. The checkbox state is saved and persists across app restarts (off by default).

⚠️ Bypass permissions is a risky, not-recommended option for unattended runs — when on, the agent writes files and runs commands without asking. It is off by default (safe mode), so enable it only in projects you trust. Unchecking it restores the usual one-time folder-trust approval.

Incremental display · loading bar

• Incremental display (pagination) — draw only 20 at a time, then "More (N left)" at the bottom for +20. The query runs once (up to 500 per project), and More just draws more of the already-fetched list, so it responds instantly (no re-query).
• Loading bar — when a query starts, the list is cleared and a progress bar ("Loading sessions…") shows inside the panel until the results arrive and replace it.
• Active-project scope — the list is based on one active project. Adding, switching, or removing a project reloads it immediately.

Cross-platform · how it finds them

The transcript paths the three CLIs leave (~/.claude/projects · ~/.codex/sessions · ~/.gemini/antigravity-cli/history.jsonl) are the same on Windows, macOS, and Linux. It picks only sessions run in the same folder as the active project, normalizing path comparison per OS convention (lowercasing on Windows only). The backend is a pure filesystem scanner independent of any DB, and all three adapters parse JSONL.

Keyboard shortcuts