@feniix/pi-sequential-thinking

@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: 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: JSON Config File

Create ~/.pi/agent/extensions/sequential-thinking.json (auto-created on first run):

{
  "storageDir": null,
  "maxBytes": 51200,
  "maxLines": 2000
}

Option 4: CLI Flags

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

Config Resolution Order

• --seq-think-config flag path
• SEQ_THINK_CONFIG environment variable
• ./.pi/extensions/sequential-thinking.json (project-level)
• ~/.pi/agent/extensions/sequential-thinking.json (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	SEQ_THINK_CONFIG	—	Custom 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:

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

Requirements

• pi v0.51.0 or later

Uninstall

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

License

MIT