Agent CLI Menu (binary `agent-cli-menu`, alias `acm`) is an open-source session manager and agent harness developed by Roy Padina. Designed to streamline workflows with terminal-based AI coding tools such as Claude Code and Codex, it acts as an interactive launcher and state manager across different repositories and tasks. In daily use, Agent CLI Menu provides an interactive terminal user interface (TUI) as well as a native macOS menu-bar GUI companion. It displays active and past agent sessions in aligned, bordered tables with details on session status, git branch, execution directory, start time, and last-used timestamps. Developers can navigate sessions with fuzzy search, view an always-on details pane, or trigger automated session recaps executed via lightweight background models (defaulting to Claude Haiku). What distinguishes Agent CLI Menu from executing standalone CLI tools directly is its session persistence layer and context recovery mechanism. Rather than manually remembering session identifiers or digging through shell history, developers can inspect prior context, read cached markdown summaries of past sessions, and resume agent threads with a single keystroke. Agent CLI Menu is open-source software available on GitHub. It operates as a local wrapper and relies on the user's existing CLI agent binaries, environment keys, and tool installations.
Tags: agent harness, cli, coding agent, developer tools, terminal
agent-cli-menu command or its shorthand alias acm. - Interactive TUI Session Browser — Navigate past and active agent sessions in an Ink-based terminal table showing branch, status, working directory, and timestamps. - Fuzzy Search and Resume — Quickly locate prior sessions with fuzzy matching and resume agent execution directly using -r or --resume. - Automated Session Recaps — Generate head-and-tail session summaries via claude -p --model haiku cached locally to ~/.config/agentclimenu/recaps/. - Always-On Details Pane — Inspect session metadata, working directory, git branch, and recap text on highlighted rows without resuming the agent first. - macOS Menu-Bar Companion — Optional native macOS GUI with resizable split-pane view to inspect sessions, generate recaps, and launch terminal windows.acm --resume to view a list of recent Claude Code or Codex sessions. By selecting a session from the table or filtering by branch name, they can immediately jump back into the exact working directory and agent state without searching terminal history.r in the TUI or run agent-cli-menu recap <id> to generate a markdown summary. The background haiku run summarizes recent edits, pending tasks, and agent conclusions to restore context before resuming.Agent CLI Menu is built for developers who regularly use terminal-based coding agents (such as Claude Code or OpenAI Codex) across multiple projects and need a fast way to track, inspect, and resume previous sessions. It is less relevant for engineers who rely solely on IDE-embedded chat plugins or run only one persistent terminal session at a time.
bash npm install -g agent-cli-menu (Note: macOS users can also build or run the native companion app from the repository's gui/ directory.)bash claude --version Launch the main Agent CLI Menu interface: bash acm To configure custom recap models or binary locations, export the relevant environment variables in your shell profile: bash export CCSM_RECAP_MODEL="claude-3-5-haiku-latest" export CCSM_CLAUDE_BIN="claude"bash acm -r 2. Use arrow keys to navigate sessions. Press r to generate or view a session recap in the details pane. 3. Press Enter to resume the highlighted agent session in your current terminal. 4. Alternatively, generate a standalone summary for a specific session ID from the command line: bash agent-cli-menu recap <session-id>Part of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools