@feniix/pi-sequential-thinking

Sequential Thinking extension for pi — structured progressive thinking through defined cognitive stages.

Features

• Process Thought (process_thought): Record and analyze sequential thoughts with stage metadata
• Generate Summary (generate_summary): Summarize the entire thinking process
• Clear History (clear_history): Reset the thinking session
• Export Session (export_session): Save thinking sessions to JSON files
• Import Session (import_session): Load previously exported sessions
• Configurable Output Limits: Client-side byte and line truncation
• Flexible Configuration: settings.json, custom JSON config files, environment variables, and CLI flags
• Native TypeScript: No external dependencies or child processes

Install

pi install npm:@feniix/pi-sequential-thinking

Ephemeral (one-off) use:

pi -e npm:@feniix/pi-sequential-thinking

Configuration

Option 1: Default Configuration

Works out of the box. Sessions are stored in ~/.mcp_sequential_thinking/.

Option 2: Environment Variables

export MCP_STORAGE_DIR="~/.my-thinking-sessions"
export SEQ_THINK_MAX_BYTES=102400
export SEQ_THINK_MAX_LINES=5000

Option 3: Settings File

Use pi's standard settings locations:

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

Under the pi-sequential-thinking key:

{
  "pi-sequential-thinking": {
    "storageDir": null,
    "maxBytes": 51200,
    "maxLines": 2000
  }
}

Best practice: use settings.json for non-secret defaults only. If you want a separate private override file, use --seq-think-config-file or SEQ_THINK_CONFIG_FILE to point to a custom JSON config file. Legacy aliases --seq-think-config and SEQ_THINK_CONFIG are still accepted but deprecated.

Option 4: CLI Flags

pi --seq-think-storage-dir=/tmp/thoughts --seq-think-max-bytes=102400

Config Resolution Order

1. --seq-think-config-file flag path
2. SEQ_THINK_CONFIG_FILE environment variable
3. legacy --seq-think-config flag path (deprecated)
4. legacy SEQ_THINK_CONFIG environment variable (deprecated)
5. .pi/settings.json under pi-sequential-thinking (project-level)
6. ~/.pi/agent/settings.json under pi-sequential-thinking (global)

Tools

process_thought

Record and analyze a sequential thought with metadata.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | thought | string | yes | The content of your thought | | thought_number | integer | yes | Position in sequence (starting at 1) | | total_thoughts | integer | yes | Expected total thoughts | | next_thought_needed | boolean | yes | Whether more thoughts follow | | stage | string | yes | One of: "Problem Definition", "Research", "Analysis", "Synthesis", "Conclusion" | | tags | string[] | no | Keywords or categories | | axioms_used | string[] | no | Principles applied | | assumptions_challenged | string[] | no | Assumptions questioned |

generate_summary

Generate a summary of the entire thinking process. Returns stage counts, timeline, top tags, and completion status.

clear_history

Reset the thinking process by clearing all recorded thoughts.

export_session

Export the current thinking session to a JSON file.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | file_path | string | yes | Path to save the exported JSON file |

import_session

Import a previously exported thinking session from a JSON file.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | file_path | string | yes | Path to the JSON file to import |

CLI Flags

| Flag | Env Variable | Default | Description | |------|-------------|---------|-------------| | --seq-think-storage-dir | MCP_STORAGE_DIR | — | Storage directory for sessions | | --seq-think-config-file | SEQ_THINK_CONFIG_FILE | — | Custom JSON config file path (overrides settings.json lookup) | | --seq-think-config | SEQ_THINK_CONFIG | — | Deprecated alias for the config file path | | --seq-think-max-bytes | SEQ_THINK_MAX_BYTES | 51200 | Max output bytes | | --seq-think-max-lines | SEQ_THINK_MAX_LINES | 2000 | Max output lines |

Thinking Stages

The Sequential Thinking framework organizes thoughts through five cognitive stages:

1. Problem Definition — Define and scope the problem
2. Research — Gather information and context
3. Analysis — Examine and evaluate the evidence
4. Synthesis — Combine insights into a coherent view
5. Conclusion — Draw final conclusions and recommendations

Requirements

• pi v0.51.0 or later

Uninstall

pi remove npm:@feniix/pi-sequential-thinking

License

MIT