Information
# agf
[](https://github.com/subinium/agf/actions)
[](https://github.com/subinium/agf/releases)
[](LICENSE)
> A fast TUI to find, resume, and manage your AI coding agent sessions.
> Supports **Claude Code** and **Codex** — all in one place.
## Quick Start
\`\`\`bash
brew install subinium/tap/agf
agf setup
\`\`\`
Restart your shell. Then just type \`agf\`.
## Why agf?
If you use AI coding agents, you've probably done this:
1. Forget which project you were working on
2. \`cd\` into the wrong directory
3. Try to remember the session ID
4. 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.
## Features
- **Unified view** — Claude Code and Codex 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
- **Session cleanup** — delete old sessions with confirmation
- **Auto-detection** — only shows agents installed on your system
## Keybindings
| 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) |
| \`Esc\` | Quit |
## Config
Optional. Create \`~/.config/agf/config.toml\`:
\`\`\`toml
sort_by = "time" # "time" | "name" | "agent"
max_sessions = 200
\`\`\`
## Supported Agents
| Agent | Resume | Data Source |
|:---|:---|:---|
| Claude Code | \`claude --resume \` | \`~/.claude/\` |
| Codex | \`codex resume \` | \`~/.codex/\` |
## Install (other methods)
## Requirements
- macOS or Linux
- One or more of: \`claude\`, \`codex\`
## Contributing
Issues and PRs are welcome.
## License
[MIT](LICENSE)