Plan mode state management for agentic loops
Plan mode state management for agentic loops. Allows agents to enter a structured planning phase, create detailed markdown plans, track plan status, and exit back to execution mode.
Flags & Options
| Flag | Short | Description | Takes Value |
|---|---|---|---|
--session |
— | Associate with session (saves plan to .scorpiox/sessions/ID/) | No |
Usage Examples
Enter plan mode with a goal
# Start planning before complex work scorpiox-planmode enter --goal "Refactor auth module to support OAuth2" → Plan mode activated. Write your plan as markdown.
Exit plan mode and save the plan
# Save your structured plan to a file scorpiox-planmode exit --plan-file ./plans/auth-refactor.md → Plan saved to ./plans/auth-refactor.md → Exiting plan mode. Returning to execution.
Check current plan mode status
# Query whether plan mode is active scorpiox-planmode status → Plan mode: ACTIVE → Goal: "Refactor auth module to support OAuth2" → Duration: 4m 32s
Export plan as JSON for tooling
# Output structured plan data as JSON scorpiox-planmode json { "active": true, "goal": "Refactor auth module to support OAuth2", "plan_file": null, "started_at": "2026-03-13T15:40:00Z" }
Reset plan mode (discard current plan)
# Abort planning and clear state scorpiox-planmode reset → Plan mode reset. No plan saved.
Session-scoped plan mode
# Associate the plan with a specific session scorpiox-planmode --session enter --goal "Migrate database schema" → Plan mode activated (session: a1b2c3d4) → Plan will be saved to .scorpiox/sessions/a1b2c3d4/
Source & Build Info
Source File
scorpiox/scorpiox-planmode.c
Lines of Code
480
Dependencies
libsxutil