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 recap <id> [--refresh]                   # AI summary of a session (cached)
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.

recap — what was this session doing?

agent-cli-menu recap <id> prints a short AI summary of a session (what it was working on, key decisions, current state, open follow-ups) so you can decide whether to resume it without reading the whole transcript. It feeds a token-capped head+tail excerpt to claude -p with the cheap/fast haiku model and caches the result to ~/.config/agentclimenu/recaps/<id>.md — re-running (or pressing r in the menu) is then instant. --refresh regenerates and overwrites the cache.

Env	Default	What
CCSM_RECAP_MODEL	haiku	Model passed to claude -p --model …
CCSM_CLAUDE_BIN	claude	The agent binary recap shells out to

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)
r	Recap the highlighted session (claude -p · haiku, cached)
/	Fuzzy-filter the list
s	Full-text search across all transcripts
^r	Refresh sessions from disk
⇥	Switch to New
?	Help overlay
q	Quit

Highlighting a row shows a details pane with its full metadata (id, status, branch, started, last used, cwd) plus the recap — no need to open the session first.

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.