Skip to content
/ agf Public

Agent Finder — One TUI to find, resume, and manage AI coding agent sessions (Claude Code, Codex)

License

Notifications You must be signed in to change notification settings

subinium/agf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

agf

CI Release License: MIT

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

agf demo

Quick Start

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
  • Bulk deleteCtrl+D to 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

Keybindings

Browse

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

Bulk Delete (Ctrl+D)

Key Action
Space Toggle selection + move down
Navigate
Enter Confirm deletion (when items selected)
Esc Cancel and return to browse

New Session (Agent Select)

Key Action
1-9 Quick select agent
Tab Open permission/approval mode picker
Enter Launch with default mode
Esc Back

Config

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

sort_by = "time"       # "time" | "name" | "agent"
max_sessions = 200

Supported Agents

Agent Resume Data Source
Claude Code claude --resume <id> ~/.claude/
Codex codex resume <id> ~/.codex/

Install (other methods)

From source
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

Contributing

Issues and PRs are welcome.

License

MIT

About

Agent Finder — One TUI to find, resume, and manage AI coding agent sessions (Claude Code, Codex)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •