name: plan-mode
title: Plan mode
repo: https://github.com/100yenadmin/hermes-plan-mode
sha: 7e77318d6d69d561a50deed07e4ae72d6498be0f
description: 'Claude Code-style plan mode on every interactive Hermes surface: /plan or /planmode on blocks mutating Hermes tools dispatched
  through pre_tool_call (writes outside .hermes/plans, terminal, code execution, delegation, MCP) while the agent
  explores, asks clarifying questions and writes a plan. The agent submits the plan with plan_mode(submit) and you
  approve it through Hermes'' own approval prompt (gateway buttons, the TUI/Desktop card, the CLI panel or /approve);
  it then implements in the same turn and tracks todo_list progress. Deny keeps planning and the agent revises.
  When yolo or approvals.mode: off would auto-approve, it asks one clarify question instead (Approve plan rev N /
  Keep planning), and only that answer approves. By default plans are compact and decision-complete and the agent
  does not commit unless asked (plan_style, allow_commits and plan_skill settings; plan_style: core keeps the
  zero-context /plan craft).
  Classic CLI enforced on every supported Hermes; gateway, TUI and Desktop from Hermes v2026.9.24 (0.21.5), and
  refused on older builds. Disclosure — plan-mode does not enforce Codex app-server exec/applyPatch or TUI
  /background and btw side agents. It reads seven internal Hermes seams for session identity, workspace, profile and
  skills.inline_shell, each guarded with a documented fallback. It creates .hermes/plans under the session working directory
  and keeps per-session state in plugin state. It adds a turn note while planning or executing, a ≤200-char
  system-prompt hint, and a one-line footer to short replies on chat platforms. When you pick "Always" on a plan
  approval, Hermes core writes a plugin_rule:plan-mode entry to command_allowlist in config.yaml. With
  allow_gateway_injection: true it queues one message to start work after a typed /planmode approve. No network
  calls, no subprocesses, no self-updater.'
maintainer: 100yenadmin
tier: community
category: tools
requires_hermes: '>=0.21.2'
docs_url: https://github.com/100yenadmin/hermes-plan-mode#readme
version: "0.3.5"
image: https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/7e77318d6d69d561a50deed07e4ae72d6498be0f/docs/media/banner.png
screenshots:
  - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/7e77318d6d69d561a50deed07e4ae72d6498be0f/docs/media/cli-approval.png
  - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/7e77318d6d69d561a50deed07e4ae72d6498be0f/docs/media/cli-deny-clarify.png
  - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/7e77318d6d69d561a50deed07e4ae72d6498be0f/docs/media/cli-approve-implement.png
platforms: []
capabilities:
  provides_tools:
    - plan_mode
  provides_hooks:
    - pre_tool_call
    - post_tool_call
    - pre_llm_call
    - transform_llm_output
    - pre_approval_request
    - post_approval_response
    - on_session_finalize
    - on_session_reset
  provides_middleware: []
  requires_env: []