FAQ

FAQ & Troubleshooting

How is this different from tmux / claude --resume?

claude --resume resumes by id from memory — you still have to know which session and which folder. Agent CLI Menu finds the right one: fuzzy-search every past session by name/path/transcript text, preview the conversation, then resume it in its original cwd. The New side adds a frecency-sorted, fuzzy launcher across all your projects. tmux organizes windows; this organizes agent sessions.

Is it safe? Does it phone home?

• Open source (MIT) — read or build every line.
• Local-only. It reads ~/.claude/ and your configured project folders and launches your terminal. No network calls of its own, no analytics, no accounts.
• --dangerously-skip-permissions is in the default Claude command (a launcher for your own machine — it's how cld always worked). Change runs in your config to drop it.

macOS says it "can't verify the developer."

The app is ad-hoc signed, not notarized (notarization needs a paid Apple Developer ID — on the roadmap). Right-click Agent CLI Menu in /Applications → Open, or run once:

xattr -dr com.apple.quarantine "/Applications/Agent CLI Menu.app"

Prefer not to trust a prebuilt binary? Build from source.

A session shows a ⚠ — what does it mean?

The working directory couldn't be decoded with certainty (a - in a folder name is ambiguous — see Architecture → cwd decoding). Resuming into the wrong directory is bad, so it asks first: press ↵ twice to resume anyway, or run agent-cli-menu resume <id> --cwd /the/right/path.

Where did cdx go? How do I launch Codex?

There's no standalone cdx command anymore — Codex is a tool inside the menu. Run agent-cli-menu (or acm) and press ⇧⇥ to cycle the tool to Codex, then ↵. Want a dedicated command? Add your own alias, e.g. alias cdx='agent-cli-menu'.

Why did my old cm / cld / ccsm commands disappear?

v0.2.0 replaced the three commands with a single agent-cli-menu (alias acm). brew upgrade --cask agentclimenu removes the old links. See the CHANGELOG.

Does it work on Linux / Windows?

The TUI is Node/ink so it's portable in principle, but cwd-decoding, kill -0/ps status, and the ~/.claude layout are tuned for macOS, and the GUI is macOS-only. Linux/Windows aren't supported yet — interest welcome via an issue.

The GUI can't find agent-cli-menu.

It probes /opt/homebrew/bin, /usr/local/bin, and ~/.local/bin for agent-cli-menu (then acm). Install via Homebrew, or npm link from source. For a custom location, set $ACM_BIN.