sequential-think

Sequential Think

Structured iterative thinking for complex problem-solving. Standalone CLI only (no MCP dependency).

Execution Methods

Run scripts/sequential_think_cli.py via Bash:

# Process a thought
python scripts/sequential_think_cli.py think \
  --thought "First, let me analyze the problem structure..." \
  --thought-number 1 \
  --total-thoughts 5

# Continue thinking chain
python scripts/sequential_think_cli.py think \
  --thought "Based on step 1, I hypothesize that..." \
  --thought-number 2 \
  --total-thoughts 5

# Revise a previous thought
python scripts/sequential_think_cli.py think \
  --thought "Reconsidering step 1, I realize..." \
  --thought-number 3 \
  --total-thoughts 5 \
  --is-revision \
  --revises-thought 1

# Branch into alternative path
python scripts/sequential_think_cli.py think \
  --thought "Alternative approach: what if we..." \
  --thought-number 4 \
  --total-thoughts 6 \
  --branch-from 2 \
  --branch-id "alt-approach"

# Final thought (complete chain)
python scripts/sequential_think_cli.py think \
  --thought "Conclusion: the solution is..." \
  --thought-number 5 \
  --total-thoughts 5 \
  --no-next

# View thought history
python scripts/sequential_think_cli.py history [--format json|text]

# Clear thought history
python scripts/sequential_think_cli.py clear

Core Principles

Iterative Thinking Process

• Each tool call = one "thought" in the chain
• Build upon, question, or revise previous thoughts
• Express uncertainty when it exists

Dynamic Thought Count

• Start with initial estimate of totalThoughts
• Adjust up/down as understanding evolves
• Add more thoughts even after reaching initial end

Hypothesis-Driven Approach

1. Generate hypotheses as potential solutions emerge
2. Verify hypotheses based on chain-of-thought steps
3. Repeat until satisfied with solution

Completion Criteria

• Only set nextThoughtNeeded: false when truly finished
• Must have satisfactory, verified answer
• Don't rush to conclusion

When to Use

| Scenario | Use Sequential Think | |----------|---------------------| | Complex debugging (3+ layers) | ✅ Yes | | Architectural analysis | ✅ Yes | | Multi-component investigation | ✅ Yes | | Performance bottleneck analysis | ✅ Yes | | Root cause analysis | ✅ Yes | | Simple explanation | ❌ No | | Single-file change | ❌ No | | Straightforward fix | ❌ No |

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | thought | string | Yes | Current thinking step content | | thoughtNumber | int | Yes | Current position in sequence (1-based) | | totalThoughts | int | Yes | Estimated total thoughts needed | | nextThoughtNeeded | bool | No | Whether more thinking needed (default: true) | | isRevision | bool | No | Whether this revises previous thinking | | revisesThought | int | No | Which thought number is being reconsidered | | branchFromThought | int | No | Branching point thought number | | branchId | string | No | Identifier for current branch | | needsMoreThoughts | bool | No | Signal that more thoughts needed beyond estimate |

Output Format

{
  "thoughtNumber": 3,
  "totalThoughts": 5,
  "nextThoughtNeeded": true,
  "branches": ["alt-approach"],
  "thoughtHistoryLength": 3
}

Workflow Pattern

Phase 1: Problem Decomposition

Thought 1: Identify problem scope and constraints
Thought 2: Break into sub-problems
Thought 3: Identify dependencies between sub-problems

Phase 2: Hypothesis Generation

Thought 4: Generate initial hypothesis
Thought 5: Identify evidence needed to verify

Phase 3: Verification & Iteration

Thought 6: Test hypothesis against evidence
Thought 7: Revise if needed (isRevision=true)
Thought 8: Branch if alternative path promising

Phase 4: Conclusion

Final Thought: Synthesize findings, provide answer (nextThoughtNeeded=false)

Best Practices

1. Start with estimate, adjust as needed
2. Initial totalThoughts is just a guess
3. Increase if problem more complex than expected
4. Decrease if solution found early

1. Use revisions for course correction
2. Mark isRevision=true when reconsidering
3. Reference revisesThought for clarity

1. Branch for alternative approaches
2. Use branchFromThought to explore alternatives
3. Give meaningful branchId names

1. Filter irrelevant information
2. Each thought should advance toward solution
3. Ignore tangential details

1. Don't rush completion
2. Only nextThoughtNeeded=false when truly done
3. Verify hypothesis before concluding

Anti-Patterns

| Prohibited | Correct | |------------|---------| | Use for simple tasks | Reserve for complex multi-step problems | | Skip thought numbers | Always increment correctly | | Conclude without verification | Verify hypothesis before final thought | | Ignore previous thoughts | Build upon or explicitly revise | | Fixed totalThoughts | Adjust as understanding evolves |

Integration with Other Tools

With ACE-Tool

ACE-Tool → align current state → Sequential Think → analyze and plan

With Context7

Sequential Think → coordinate analysis → Context7 → provide official patterns

With Serena

Serena → symbol-level exploration → Sequential Think → systematic analysis