The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
plugin-catalog: plan-mode (maintainer copy of #138297)
Evab6b02df37d9a
diff --git a/plugin-catalog/plan-mode.yaml b/plugin-catalog/plan-mode.yamlindex 1937185289a..028573fa5ef 100644--- a/plugin-catalog/plan-mode.yaml+++ b/plugin-catalog/plan-mode.yaml@@ -1,40 +1,55 @@name: plan-modetitle: Plan moderepo: https://github.com/100yenadmin/hermes-plan-mode-sha: 9cd020105ac76409af164262195f8de77eace8a0-description: 'Claude Code-style plan mode on every interactive Hermes surface: /plan or /planmode on blocks mutating Hermes tools dispatched+sha: 118a92acda2cc462358e35894f82ebb46f4d5996+description: 'Claude Code-style plan mode for Hermes: the agent explores and writes a plan, and edits nothing else until you+ approve it. It works on every interactive Hermes surface: /plan or /planmode on blocks mutating Hermes tools dispatchedthrough 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). The default lean profile keeps compact planning short: a brief planning note, at- most three targeted questions, and no todo bookkeeping for short plans (plan_profile: classic keeps 0.3.5); on- TUI, Desktop and hermes serve the agent writes the plan once, in its reply, and the plugin saves it.- 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 eight groups of 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. On TUI, Desktop- and hermes serve sessions (lean profile, plan_once) it reads the visible reply text from post_api_request while- planning and saves its <proposed_plan> block as the plan file. No network- calls, no subprocesses, no self-updater.'+ explores, asks clarifying questions and writes a plan. The agent shows the complete plan, submits it with+ plan_mode(submit) and one approval card asks: approve and auto-accept edits, approve and review each file edit+ (when Hermes approvals are on, every write_file and patch then gets Hermes'' approval prompt with its path and a+ preview), or keep planning; Other sends feedback, and the revised plan says what changed since the last revision.+ Once approved, it implements in the same turn and tracks todo_list progress. To change the plan yourself, keep+ planning, run /planmode edit, save, then /planmode show and /planmode approve; the text you were shown is saved as+ an approved snapshot, so later edits to the file do not change the approval. The classic profile+ (plan_profile: classic), approval_card: false and surfaces without a card use Hermes'' own approval prompt+ (gateway buttons, the TUI/Desktop card, the CLI panel or /approve). When yolo or approvals.mode: off would+ auto-approve, it asks through clarify instead, so a person still decides. By default plans are compact and+ decision-complete, the lean profile asks at most three targeted questions, and the agent does not commit unless+ asked (plan_style, plan_profile, allow_commits and plan_skill settings). Classic CLI enforced on every supported+ Hermes; gateway, TUI and Desktop from Hermes v2026.9.24 (0.21.5), and refused on older builds; 0.21.6 recommended.+ On the interactive classic CLI, Hermes'' inline diff shows a new plan file in full, so the agent does not retype it+ (write_once). A report-a-problem skill drafts a bug report and files it with gh only after you approve the draft.+ Disclosure — plan-mode does not enforce Codex app-server exec/applyPatch or TUI /background and btw side agents.+ A plan is approved only on its approval card (a clarify question only the plugin issues and checks), through+ Hermes'' own approval prompt, or with /planmode approve. It reads nine groups of internal Hermes seams for session+ identity, workspace, profile, skills.inline_shell and the classic CLI''s inline diff, each guarded with a documented fallback. It creates+ .hermes/plans under the session working directory, reads plan files there, saves the approved text of an edited+ plan as a new file under .hermes/plans/approved, 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 a turn ends while a submitted plan still awaits approval and no approval card was answered, it adds+ one line to that reply on any surface, whatever its length, saying how to approve (unless footer is off). When you+ pick "Always" on a plan approval or a per-edit review, Hermes core writes a+ plugin_rule:plan-mode entry to command_allowlist in config.yaml; each entry is keyed to one plan revision, so it+ cannot approve another plan. With allow_gateway_injection: true it queues one message to start work after a typed+ /planmode approve. On TUI, Desktop and hermes serve sessions (lean profile, plan_once) it reads the visible reply+ text from post_api_request while planning and saves its <proposed_plan> block as the plan file. On the interactive+ classic CLI (lean, write_once) it checks that Hermes printed a newly written plan file in full, then tells the agent+ not to retype it. Its report-a-problem skill has the agent file to the plugin repository with gh only after the user+ approves the exact saved draft. The plugin itself makes no network calls, launches no subprocesses and has no+ self-updater.'maintainer: 100yenadmintier: communitycategory: toolsrequires_hermes: '>=0.21.3'docs_url: https://github.com/100yenadmin/hermes-plan-mode#readme-version: "0.4.4"-image: https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/9cd020105ac76409af164262195f8de77eace8a0/docs/media/banner.png+version: "0.6.8"+image: https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/118a92acda2cc462358e35894f82ebb46f4d5996/docs/media/banner.pngscreenshots:- - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/9cd020105ac76409af164262195f8de77eace8a0/docs/media/cli-approval.png- - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/9cd020105ac76409af164262195f8de77eace8a0/docs/media/cli-deny-clarify.png- - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/9cd020105ac76409af164262195f8de77eace8a0/docs/media/cli-approve-implement.png+ - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/118a92acda2cc462358e35894f82ebb46f4d5996/docs/media/cli-card.png+ - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/118a92acda2cc462358e35894f82ebb46f4d5996/docs/media/cli-edit-review.png+ - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/118a92acda2cc462358e35894f82ebb46f4d5996/docs/media/cli-card-implement.png+ - https://raw.githubusercontent.com/100yenadmin/hermes-plan-mode/118a92acda2cc462358e35894f82ebb46f4d5996/docs/media/cli-edit-approve.pngplatforms: []capabilities:provides_tools: