Files
hermes-agent/plugin-catalog/plan-mode.yaml

31 lines
1.7 KiB
YAML

name: plan-mode
title: Plan mode
repo: https://github.com/100yenadmin/hermes-plan-mode
sha: 33e59f94fd39ebe10b049bc01fcfb68f4276477b
description: 'Enforced per-session plan mode: /planmode on blocks mutating Hermes tools dispatched through pre_tool_call (writes outside
.hermes/plans, terminal, code execution, delegation, MCP) until you /planmode approve the plan. Fails closed. Enforced in the classic CLI on every
supported Hermes; gateway, TUI and Desktop are enforced from Hermes v2026.9.24 (0.21.5, which carries hermes-agent commits 5943347a2a and
35fdb4608a) and refuse /planmode on on older builds. The plan_mode tool lets the agent enter plan mode itself (on/status/off; approval stays /planmode approve); behind Tool Search the model finds it via tool_search. Disclosure: Codex app-server native exec and TUI side agents bypass pre_tool_call and are not enforced. Disclosure — reads two private Hermes internals without
modifying them (gateway.run._gateway_runner_ref via sys.modules to detect a gateway process, and
PluginContext._manager.home_path to learn its profile), both guarded with fallbacks; creates .hermes/plans/ under the
session working directory; the plan_mode tool''s off action ends only a plan mode the agent entered itself. No network
access, no shell, no self-update.'
maintainer: 100yenadmin
tier: community
category: tools
requires_hermes: '>=0.21.2'
docs_url: https://github.com/100yenadmin/hermes-plan-mode#readme
version: "0.2.0"
platforms: []
capabilities:
provides_tools:
- plan_mode
provides_hooks:
- pre_tool_call
- post_tool_call
- pre_llm_call
- on_session_finalize
- on_session_reset
provides_middleware: []
requires_env: []