agf

Find the AI coding session you meant to resume.

agf is a local-first fuzzy finder for AI coding-agent sessions. Search the sessions your terminal agents already keep locally, then resume the right one in a keystroke.

Install

cargo install agf
agf setup
agf

Requires a Rust toolchain (rustup recommended). Prebuilt binaries for macOS, Linux, and Windows are also available on the Releases page.

Quick Resume (no TUI)

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

Why agf?

AI coding agents are great at keeping context — until you lose the terminal.

You switch projects, close a tab, forget the session ID, or resume the wrong agent. Then you either dig through history files or start over.

agf gives you one searchable list of local agent sessions and resumes the right one.

Supported agents

agf reads the session files each agent already stores locally. No account, no cloud sync, no extra agent process.

Features

• Cross-agent search — see all supported agents in one list
• Fuzzy search — find sessions by project name, path, branch, or summary
• One-key resume — resume the selected session with the right agent command
• Quick resume — agf resume <query> skips the TUI entirely
• Bulk delete — Ctrl+D to multi-select and clean up stale sessions
• Project awareness — git branches and Claude Code --worktree sessions surface in the UI

Also supports Unicode/CJK search, mouse navigation, agent filters, permission/approval-mode picker, agent auto-detection, and shell wrappers for zsh, bash, fish, and PowerShell.

Basic controls

Configuration

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"
include_non_interactive = false # show Codex subagent/exec threads

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

Shell integration

agf setup auto-detects your shell and installs the wrapper. Use agf setup --shell powershell (or another supported shell) when auto-detection is ambiguous.

• zsh / bash — appends to ~/.zshrc or ~/.bashrc
• fish — writes to ~/.config/fish/config.fish
• PowerShell (Windows or cross-platform pwsh) — writes to $PROFILE.CurrentUserAllHosts (Documents\PowerShell\profile.ps1 on Windows, ~/.config/powershell/profile.ps1 elsewhere)

If auto-detection misses your shell, run the matching agf init form manually:

eval "$(agf init zsh)"                               # zsh
eval "$(agf init bash)"                              # bash
agf init fish | source                               # fish
agf init powershell | Out-String | Invoke-Expression # PowerShell

After upgrading, run agf setup again (or restart your shell) to apply the latest wrapper. See CHANGELOG.md for release notes.

Requirements

• macOS, Linux, or Windows (PowerShell 5.1+ / PowerShell 7+)
• One or more of: claude, codex, grok, kimi, qwen, prime-agent, opencode, pi, kiro-cli, cursor-agent, gemini, hermes, omp, yolop

Install from source

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

Limitations

agf works best with agents that store resumable sessions locally.

Direct deletion is intentionally disabled for Prime Agent, Grok Build, Kimi Code, and Qwen Code. Their native pickers coordinate active sessions and/or secondary indexes; deleting only the visible file from AGF could leave corrupted or stale upstream state. Discovery and exact-ID resume remain fully supported.

Amp is not supported yet because its sessions are stored remotely, which makes it hard to reliably resolve local project paths from session metadata. We are monitoring upstream changes and will add support when feasible.

Built with

agf is written in Rust and built with SuperLightTUI (SLT) — an immediate-mode terminal UI library for Rust.

Contributing

Issues and PRs are welcome. Adding support for another agent/harness is a self-contained change — see docs/adding-an-agent.md for the wiring checklist.

License

MIT