agf

A fast TUI to find, resume, and manage your AI coding agent sessions. Supports Claude Code, Codex, OpenCode, pi, Kiro, Cursor CLI, and Gemini — all in one place.

Quick Start

brew install subinium/tap/agf
agf setup

Restart your shell. Then just type agf.

Quick Resume (no TUI)

agf resume project-name   # fuzzy-matches and resumes the best match directly

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, Codex, OpenCode, pi, Kiro, Cursor CLI, and Gemini 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+D to multi-select and batch-delete sessions
• New session — launch a new agent session with optional permission mode
• Quick resume — agf resume <query> to skip the TUI and resume directly
• Auto-detection — only shows agents installed on your system
• Git branch — shows the current branch of each project's working directory
• Worktree support — detects Claude Code --worktree sessions; shows worktree name in the list and parent branch in the detail view

Keybindings

Browse

Bulk Delete (Ctrl+D)

New Session (Agent Select)

Config

Optional. Create ~/.config/agf/config.toml:

sort_by = "time"            # "time" | "name" | "agent"
max_sessions = 200
search_scope = "name_path"  # "name_path" (default) | "all" (include summaries)
summary_search_count = 5    # number of summaries included when search_scope = "all"

You can also edit search_scope and summary_search_count interactively by pressing ? in the TUI.

Supported Agents

Session Storage Paths

Install (other methods)

git clone https://github.com/subinium/agf.git
cd agf
cargo install --path .
agf setup

Requirements

• macOS or Linux
• One or more of: claude, codex, opencode, pi, kiro-cli, cursor-agent

Contributing

Issues and PRs are welcome.

Contributors

License

MIT

Agent Support Roadmap

Amp is not yet supported. Amp stores sessions on a remote server, making it difficult to reliably resolve project paths from session metadata. We are monitoring upstream changes and will add support when feasible.