Commands

Commands

There's one command — agent-cli-menu — with a short alias acm. It opens the menu in New mode; -r/--resume opens it in Resume mode.

agent-cli-menu          # New-session menu (default)
agent-cli-menu -r       # Resume menu
agent-cli-menu --resume # same as -r
acm                     # alias for agent-cli-menu
acm -r                  # alias for agent-cli-menu -r

Inside the menu, ⇥ (Tab) switches between New and Resume at any time, so you can start in either and flip.

Want cld/cdx-style per-tool shortcuts? Add your own shell aliases, e.g. alias cld='agent-cli-menu'. The tool you launch is chosen in-menu (⇧⇥ cycles it).

Non-interactive subcommands

agent-cli-menu ls [--cwd <path>] [--active] [--json] [--sort updated|started|name] [--limit N]
agent-cli-menu peek <id> [--full] [--head N --tail N]   # print a transcript
agent-cli-menu resume <id> [--yes] [--cwd <override>]   # resume by id (prefix ≥ 4 chars)
agent-cli-menu path <id>                                # print the .jsonl path
agent-cli-menu config --setup | --edit | --path         # manage the shared config
agent-cli-menu --help                                   # full usage

<id> accepts a unique prefix (≥ 4 characters). resume launches claude --resume <id> --dangerously-skip-permissions in the session's working directory.

Keyboard — New

Key	Action
↑ / ↓	Move selection
type	Fuzzy-filter the project dirs
↵	Launch the selected tool in the dir
⇥	Switch to Resume
⇧⇥	Cycle the tool (e.g. Claude ⇄ Codex)
^n	New directory (then launch)
^t	Open in tmux
^p	git pull first, then launch
^f	Reveal in Finder
^-key	Open a configured IDE, then launch
?	Full keymap overlay
esc	Clear the filter / quit

Keyboard — Resume

Key	Action
↑ / ↓ (or j / k)	Move selection
↵	Resume the selected session
p	Peek the transcript (scroll: ↑/↓, g/G, pgup/pgdn)
/	Fuzzy-filter the list
s	Full-text search across all transcripts
r	Refresh sessions from disk
⇥	Switch to New
?	Help overlay
q	Quit

A ⚠ marks a session whose working directory couldn't be decoded with confidence — press ↵ twice to resume anyway, or use agent-cli-menu resume <id> --cwd <path>. See Architecture → cwd decoding.