Summary

Implements the /plan slash command requested in #36821. The command renders the agent's in-process TodoStore as a boxed table with status markers, so users can check task progress without waiting for the agent to respond. No LLM round-trip.

Subcommands

• /plan — show all items (pending / in_progress / completed / cancelled)
• /plan pending — only pending + in_progress
• /plan clear — wipe the list (with confirmation; --yes / now skip)

Example

  📋 Current Plan
  ┌──────────────────────────────────────────────┐
  │ Current Plan                                 │
  ├──────────────────────────────────────────────┤
  │  1. ✓ Set up project structure               │
  │  2. ✓ Implement auth module                  │
  │  3. ● Write integration tests  (in_progress) │
  │  4. ○ Deploy to staging                      │
  │  5. ○ Update documentation                   │
  │  6. ✗ Abandoned idea                         │
  └──────────────────────────────────────────────┘
  Progress: 2/5 completed
  (1 cancelled item hidden from progress count)

Implementation

• Registered CommandDef("plan", "Show the agent's current todo list", "Session", cli_only=True, args_hint="[pending|clear]") in hermes_cli/commands.py.
• Added HermesCLI._handle_plan_command in cli.py that reads self.agent._todo_store (initialized in agent/agent_init.py:1042) and renders a Unicode-bordered table.
• Wired the dispatch in HermesCLI.process_command.
• /plan clear reuses the existing destructive-slash confirmation gate (_confirm_destructive_slash) and inline --yes / now skip tokens, matching the /new and /reset patterns.

Why CLI-only

The issue labels include comp/cli, comp/tui and the body describes "in the TUI". The agent's TodoStore is per-AIAgent, and surfacing it through the gateway would require sourcing the right agent for the session key plus i18n translations. Keeping it CLI-only matches the issue's "first PR" framing and the scope of existing CLI-only commands like /history and /save. Gateway support can be added as a follow-up if there's demand.

Test plan

• New tests/cli/test_cli_plan_command.py (19 tests) covers:
  • Registry entry + metadata
  • process_command dispatch + no collision with /status or /history
  • Empty store, no agent, unknown subcommand, default render
  • pending filter behaviour
  • clear with approval, cancellation, empty store, no agent
  • --yes and now skip tokens bypass the gate
  • Box-drawing borders align
• Manually exercised against MagicMock-backed HermesCLI instances and a real TodoStore.

Platforms

• Tested on macOS aarch64, Python 3.11.15, hermes venv.
• check-windows-footguns.py reports no issues.
• ruff check clean.

Out of scope

• Ctrl+P keybinding (mentioned as optional in the issue, easy follow-up).
• Gateway (/plan from Telegram/Discord/Slack) — see "Why CLI-only" above.

Fixes #36821.

🤖 Generated with Claude Code