Home

Agent CLI Menu

One menu for every Claude & Codex session — start a new one in any project, or fuzzy-search and resume an old one (with a transcript preview). A terminal TUI (agent-cli-menu / acm) and a native macOS menu-bar GUI, sharing one config.

brew install --cask roypadina/tap/agentclimenu

agent-cli-menu        # New-session menu (default)
agent-cli-menu -r     # Resume menu
acm  /  acm -r        # short alias, identical

Pages

• Installation — Homebrew, from source, requirements, Gatekeeper, upgrade/uninstall.
• Commands — agent-cli-menu / acm, -r, subcommands, and every keyboard shortcut.
• Configuration — the shared TOML: groups, tools, IDE keybinds, GUI/terminal, hotkey.
• GUI — the menu-bar app: tabs, details + recap, transcript preview, Settings editor, global hotkey.
• Architecture — how it finds, decodes, and resumes sessions; the core/cli split.
• FAQ & Troubleshooting — Gatekeeper, the ⚠ cwd warning, Codex, privacy, "why not tmux".

What it does

• New — pick a project directory (grouped, frecency-sorted, fuzzy-filtered) and launch your agent there. Open it in your IDE first, in tmux, after a git pull, or make a brand-new directory on the fly.
• Resume — fuzzy-search every Claude Code session by name, path, or full transcript text, preview the conversation, recap it with one keystroke (a cached AI summary), and resume it in its original working directory.

It's local-only — it reads ~/.claude/ and your configured project folders, and runs no network calls of its own.

---

Repo: github.com/roypadina/AgentCliMenu · MIT © Roy Padina · Support on Ko-fi ☕