A fast TUI to find, resume, and manage your AI coding agent sessions. Supports Claude Code, Codex, and OpenCode — all in one place.
brew install subinium/tap/agf
agf setupRestart your shell. Then just type agf.
If you use AI coding agents, you've probably done this:
- Forget which project you were working on
cdinto the wrong directory- Try to remember the session ID
- Give up and start a new session
agf fixes that. It scans all your agent sessions, shows them in a searchable list, and lets you resume with one keystroke.
- Unified view — Claude Code, Codex, and OpenCode sessions in one list
- Fuzzy search — find any session by project name or summary
- One-key resume — select a session and hit Enter
- Agent filter — Tab to cycle through agents
- Smart cd — jump to any project directory
- Bulk delete —
Ctrl+Dto multi-select and batch-delete sessions - New session — launch a new agent session with optional permission mode
- Auto-detection — only shows agents installed on your system
| Key | Action |
|---|---|
| Type anything | Fuzzy search |
↑ ↓ |
Navigate |
Enter |
Open action menu |
→ |
Preview session details |
Tab / Shift+Tab |
Cycle agent filter |
Ctrl+S |
Cycle sort (time / name / agent) |
Ctrl+D |
Enter bulk delete mode |
Esc |
Quit |
| Key | Action |
|---|---|
Space |
Toggle selection + move down |
↑ ↓ |
Navigate |
Enter |
Confirm deletion (when items selected) |
Esc |
Cancel and return to browse |
| Key | Action |
|---|---|
1-9 |
Quick select agent |
Tab |
Open permission/approval mode picker |
Enter |
Launch with default mode |
Esc |
Back |
Optional. Create ~/.config/agf/config.toml:
sort_by = "time" # "time" | "name" | "agent"
max_sessions = 200| Agent | Resume | Data Source |
|---|---|---|
| Claude Code | claude --resume <id> |
~/.claude/ |
| Codex | codex resume <id> |
~/.codex/ |
| OpenCode | opencode -s <id> |
~/.local/share/opencode/opencode.db |
From source
git clone https://github.com/subinium/agf.git
cd agf
cargo install --path .
agf setup- macOS or Linux
- One or more of:
claude,codex,opencode
Issues and PRs are welcome.
Gemini CLI and Amp are not yet supported. Both tools store session data without a direct mapping between session files and project directories, making it difficult to reliably resolve project paths from session metadata. We are monitoring upstream changes and will add support when feasible.