coja
a700e23e0a
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)
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# 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
|
|
```
|
|
|
|
4. Choose "Execute the plan" when prompted
|
|
5. During execution, the agent marks steps complete with `[DONE:n]` tags
|
|
6. 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`
|