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, 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, 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 ☕