@feniix/pi-code-reasoning

Code Reasoning extension for pi — reflective problem-solving through sequential thinking with branching and revision support.

Based on the MCP server by Matt Westgate, this native TypeScript extension provides structured thinking tools without external dependencies.

Features

• Sequential Thinking — Break down complex problems into structured, revisable steps
• Branching — Explore alternative approaches from any thought (🌿)
• Revision — Correct earlier thinking when new insights emerge (🔄)
• Progress Tracking — Track thought count and branches
• Configurable Output — Client-side byte and line truncation

Install

pi install npm:@feniix/pi-code-reasoning

Ephemeral (one-off) use:

pi -e npm:@feniix/pi-code-reasoning

Tools

code_reasoning

Record and process a thought with metadata.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | thought | string | yes | Your reasoning content | | thought_number | integer | yes | Position in sequence | | total_thoughts | integer | yes | Estimated total thoughts | | next_thought_needed | boolean | yes | Set FALSE when done | | is_revision | boolean | no | When correcting earlier thought (🔄) | | revises_thought | integer | no | Which thought# you're revising | | branch_from_thought | integer | no | When exploring alternatives (🌿) | | branch_id | string | no | Identifier for the branch | | needs_more_thoughts | boolean | no | If more thoughts needed |

code_reasoning_status

Get current session status: branches and thought count.

code_reasoning_reset

Reset the session, clearing all thoughts and branches.

Thinking Patterns

Sequential Thinking (Basic)

{
  "thought": "Initial exploration of the problem...",
  "thought_number": 1,
  "total_thoughts": 5,
  "next_thought_needed": true
}

Branching (Explore Alternatives) 🌿

{
  "thought": "Exploring alternative approach...",
  "thought_number": 3,
  "total_thoughts": 7,
  "next_thought_needed": true,
  "branch_from_thought": 2,
  "branch_id": "alternative-algo-x"
}

Revision (Correct Earlier Thinking) 🔄

{
  "thought": "Revisiting earlier point: Assumption Y was flawed...",
  "thought_number": 4,
  "total_thoughts": 6,
  "next_thought_needed": true,
  "is_revision": true,
  "revises_thought": 2
}

Checklist (Review Every 3 Thoughts)

1. Need to explore alternatives? → Use BRANCH (🌿)
2. Need to correct earlier thinking? → Use REVISION (🔄)
3. Scope changed? → Adjust total_thoughts
4. Done? → Set next_thought_needed = false

Configuration

CLI Flags

pi --code-reasoning-max-bytes=102400 --code-reasoning-max-lines=5000

Environment Variables

export CODE_REASONING_MAX_BYTES=102400
export CODE_REASONING_MAX_LINES=5000

Settings File

Use pi's standard settings locations for non-secret configuration:

• project: .pi/settings.json
• global: ~/.pi/agent/settings.json

Under the pi-code-reasoning key:

{
  "pi-code-reasoning": {
    "maxBytes": 51200,
    "maxLines": 2000
  }
}

Best practice: use settings.json for non-secret defaults only. If you need a separate private override file, use --code-reasoning-config-file or CODE_REASONING_CONFIG_FILE to point to a custom JSON config file. Legacy aliases --code-reasoning-config and CODE_REASONING_CONFIG are still accepted but deprecated.

CLI Flags

| Flag | Env Variable | Default | Description | |------|-------------|---------|-------------| | --code-reasoning-config-file | CODE_REASONING_CONFIG_FILE | — | Custom JSON config file path (overrides settings.json lookup) | | --code-reasoning-config | CODE_REASONING_CONFIG | — | Deprecated alias for the config file path | | --code-reasoning-max-bytes | CODE_REASONING_MAX_BYTES | 51200 | Max output bytes | | --code-reasoning-max-lines | CODE_REASONING_MAX_LINES | 2000 | Max output lines |

Requirements

• pi v0.51.0 or later

License

MIT