Product Wiki
askTerminal
askTerminal is a macOS app for launching, supervising, and coordinating Claude Code and Codex sessions across local projects. It combines terminals, project kanban views, EPIC planning, approval hooks, analytics, and a quick global agent panel.
Agent Command Center
Open Claude Code or Codex sessions from project context, resume prior sessions, fork sessions, and keep work visible in dedicated terminal windows.
Project Intelligence
Read local Claude and Codex metadata, render session history, display todos by status, and surface changed files, plans, instructions, skills, and agents.
Human Approval Loop
Install local hooks, listen for permission requests, and present approvals in the notch UI and permission list before sensitive tool execution continues.
What The Product Does
askTerminal turns AI coding sessions into a manageable workspace. Instead of treating each CLI session as a loose terminal tab, the app indexes sessions by project, tracks task state, helps resume or fork work, shows analytics, and lets agents coordinate through local files and message channels.
The current codebase supports two engines: Claude Code and Codex. Claude sessions contribute todo files and project JSONL transcripts. Codex sessions are read from the Codex SQLite state and transcript directories. The app normalizes both into a shared session model.
Primary Surfaces
| Surface | Purpose | Source modules |
|---|---|---|
| Status item and main window | Menu bar entry, terminal list, project picker, settings access, and window toggles. | codepro2App.swift |
| Terminal windows | Run shell, Claude, or Codex commands in project-aware windows with command history and chat-style output. | SwiftTerminal, GhosttyTerminal.swift |
| Kanban window | Project sessions, todos, plans, skills, agents, instructions, analytics, and git changes. | KanbanModel.swift, KanbanView.swift |
| Notch UI | Top-center floating panel for quick agent messages and approval requests. | NotchUI/, QuickAgentManager.swift |
| Settings | Quick Agent engine/workspace settings, session reset actions, and shortcuts. | SettingsView |
Engine Support
| Capability | Claude Code | Codex |
|---|---|---|
| New session | claude | codex |
| Resume session | claude --resume | codex resume |
| Fork session | claude --resume ... --fork-session | codex fork |
| Todos | Supported through ~/.claude/tasks | Not supported by Codex backend |
| Transcript analytics | ~/.claude/projects | ~/.codex/sessions and ~/.codex/archived_sessions |
Documentation Map
Read Getting Started for installation and first-run setup. Use Core Workflows for day-to-day operation. Use Architecture & Storage when debugging data files or extending the app.