Files
dots/common/.pi/agent/extensions/plan-mode
coja a700e23e0a [Sync] adopt unified stow layout from the private repo
Mirrors the private dots tree at 900bdda: one shared base plus per-host
overlays, replacing the old flat .config/ layout (last synced 2026-06-28).

- packages: common/ gui/ wm/ lw/ fl/ + install.sh and bin/ tooling (dotsync,
  reconcile-hyde.sh)
- new README (layout, deploy order, HyDE dependency), plus ToDo.md and
  HYDE-UPDATE.md
- current HyDE waybar rig (layouts/, cava), pi agent extensions, claude/
  config, tmux, presenterm, aichat roles
- drops stale duplicates and generated cruft that should never have been
  tracked: the second top-level .pi/ copy, btop.log, zellij config.kdl.bak,
  fish_variables, nvim codecompanion.lua
- .pi/agent/auth.json is gitignored now; auth.json.example ships instead
- fl/ and wm/ hypr themes/ stay untracked (HyDE-generated per machine, per
  the root .gitignore)
2026-08-12 22:50:18 +02:00
..

Plan Mode Extension

Read-only exploration mode for safe code analysis.

Features

  • Built-in write tools disabled: Disables edit/write while preserving other active tools
  • Bash allowlist: Only read-only bash commands are allowed
  • Plan extraction: Extracts numbered steps from Plan: sections
  • Progress tracking: Widget shows completion status during execution
  • [DONE:n] markers: Explicit step completion tracking
  • Session persistence: State survives session resume

Commands

  • /plan - Toggle plan mode
  • /todos - Show current plan progress
  • Shift+Tab - Toggle plan mode (shortcut; this fork rebinds it from upstream's Ctrl+Alt+P)

Usage

  1. Enable plan mode with /plan or --plan flag
  2. Ask the agent to analyze code and create a plan
  3. The agent should output a numbered plan under a Plan: header:
Plan:
1. First step description
2. Second step description
3. Third step description
  1. Choose "Execute the plan" when prompted
  2. During execution, the agent marks steps complete with [DONE:n] tags
  3. Progress widget shows completion status

How It Works

Plan Mode (Read-Only)

  • Built-in edit/write tools disabled
  • Other active tools remain available
  • Bash commands filtered through allowlist
  • Agent creates a plan without making changes

Execution Mode

  • Full tool access restored
  • Agent executes steps in order
  • [DONE:n] markers track completion
  • Widget shows progress

Command Allowlist

Safe commands (allowed):

  • File inspection: cat, head, tail, less, more
  • Search: grep, find, rg, fd
  • Directory: ls, pwd, tree
  • Git read: git status, git log, git diff, git branch
  • Package info: npm list, npm outdated, yarn info
  • System info: uname, whoami, date, uptime

Blocked commands:

  • File modification: rm, mv, cp, mkdir, touch
  • Git write: git add, git commit, git push
  • Package install: npm install, yarn add, pip install
  • System: sudo, kill, reboot
  • Editors: vim, nano, code