scorpiox-planmodeCore

Plan mode manager for complex task planning. Enables structured planning workflows with markdown-based plans for multi-step operations.

Linux x64 Linux ARM64 macOS ARM64 Windows x64

⚙️ Flags & Options

This tool operates without flags — it is controlled through subcommands and interactive prompts.

💡 Usage Examples

Enter plan mode for a new goal

# Start plan mode with a description of the goal
$ scorpiox-planmode enter --goal "Migrate database from PostgreSQL to MySQL"

✔ Entered plan mode
  Goal: Migrate database from PostgreSQL to MySQL
  Write your plan to a markdown file, then exit with --plan-file

Exit plan mode with a completed plan

# Save your plan and exit plan mode
$ scorpiox-planmode exit --plan-file ./plans/db-migration.md

✔ Plan saved: ./plans/db-migration.md
  Plan mode exited — ready for execution

Check current plan mode status

# See if plan mode is active and what the current goal is
$ scorpiox-planmode status

Plan Mode: ACTIVE
  Goal: Migrate database from PostgreSQL to MySQL
  Entered: 2 minutes ago

Export plan as structured JSON

# Get the current plan in machine-readable JSON format
$ scorpiox-planmode json

{"goal":"Migrate database from PostgreSQL to MySQL",
 "status":"active",
 "plan_file":"./plans/db-migration.md",
 "steps":12}

Reset plan mode (discard current plan)

# Cancel and clear the current plan mode session
$ scorpiox-planmode reset

✔ Plan mode reset — no active plan

Typical workflow with scorpiox-tasks

# 1. Enter plan mode to think through the approach
$ scorpiox-planmode enter --goal "Add OAuth2 login to the API"

# 2. Write a detailed plan in markdown
$ cat > /tmp/oauth-plan.md << 'EOF'
# OAuth2 Implementation Plan
1. Add oauth2 dependency to Cargo.toml
2. Create /auth/login and /auth/callback routes
3. Store tokens in session middleware
4. Add protected route middleware
5. Write integration tests
EOF

# 3. Exit plan mode, linking the plan file
$ scorpiox-planmode exit --plan-file /tmp/oauth-plan.md

# 4. Convert plan steps into tracked tasks
$ scorpiox-tasks create "Add OAuth2 login to the API"

📦 Source & Build Info

Source File
scorpiox/scorpiox-planmode.c
Lines of Code
486
Dependencies
libsxutil