Installation

Web (No Install)

▶️ synthanai.github.io/spar-kit

ChatGPT GPT (No Install)

🤖 SPAR Decision Partner — Use SPAR directly in ChatGPT

CLI

npm install -g sparkit

Usage

# 🎯 Launch TUI Mission Control (recommended)
sparkit tui

# 🧙 Launch SPAR Builder wizard
sparkit builder

# ⚡ Quick debate
sparkit "Should we expand to Singapore?"

# 📝 Full command
sparkit debate start "Your decision here"

# 📦 Use a template
sparkit template use startup-pivot

TUI Features (v4.0.0)

• Dashboard: View all sessions with status indicators
• Session Management: Pause, resume, cancel, clone debates
• Live Monitoring: Watch debates unfold in real-time
• Persona Browser: Browse 109 personas across 7 archetypes
• 3-Round Rumble: Structured Opening → Clash → Final protocol
• Keyboard Navigation: Full keyboard control (see docs/KEYBOARD_SHORTCUTS.md)

Commands

Core Commands

| Command | Description | |---------|-------------| | spar | Start interactive debate | | spar tui | NEW! Launch Mission Control TUI | | spar builder | NEW! Launch SPAR Builder wizard | | spar debate start [topic] | Start debate session | | spar debate history | View past sessions |

Template Commands (NEW!)

| Command | Description | |---------|-------------| | spar template list | Show all templates | | spar template show <id> | View template details | | spar template use <id> | Use template to start debate | | spar template create | Create custom template | | spar template delete <id> | Delete a template |

Built-in Templates

| Template | Preset | Use Case | |----------|--------|----------| | startup-pivot | 🚀 Startup | Evaluate major pivots | | hiring-decision | 💼 Corporate | Should you hire this person? | | investment-eval | 💼 Corporate | Evaluate investments | | product-launch | 🎨 Innovation | Launch readiness | | crisis-response | ⚠️ Crisis | Emergency decisions | | ethics-dilemma | ⚖️ Ethics | Navigate ethical situations |

Other Commands

| Command | Description | |---------|-------------| | spar persona list | Show all 108 personas | | spar persona create | Create custom persona | | spar config setup | Configure provider & API key | | spar config show | View configuration | | spar status | Show version & stats | | spar compass | Display N-E-W-S framework |

The SPARKIT Protocol

S — SCOPE       Define the question precisely
P — POPULATE    Instantiate clashing personas  
A — ANNOUNCE    Present the challenge equally
R — RUMBLE      3-round structured dialectic:
                - R1: Opening (1500 tokens)
                - R2: Clash (1200 tokens)
                - R3: Final (1000 tokens)
K — KNIT        Moderator synthesizes tensions (21k tokens)
I — INTERROGATE Stress-test the synthesis
T — TRANSMIT    Extract actionable recommendations

The Four Directions

                    🔵 NORTH
                   The Visionary
                "Where are we going?"
                         │
    🔴 WEST ─────────────┼───────────── 🟢 EAST
    The Sage             │          The Challenger
 "What's proven?"        │       "What's emerging?"
                         │
                    🟡 SOUTH
                  The Pragmatist
               "What's grounded?"

Configuration

Global config: ~/.spar/

~/.spar/
├── config.json     # Provider + API key
├── personas/       # Custom personas
└── sessions/       # Auto-saved debates

Providers

| Provider | Model | |----------|-------| | OpenAI | GPT-4 Turbo | | Anthropic | Claude 3.5 Sonnet | | Google | Gemini 1.5 Flash |

Security

• API keys stored locally in ~/.spar/config.json
• No server — direct API calls to your provider
• Web version uses browser localStorage

Testing

# Run all tests (102 tests)
npm test

# Watch mode
npm run test:watch

# Coverage report
npm run test:coverage

Test Suite

| Suite | Tests | Coverage | |-------|-------|----------| | cli.test.js | CLI configuration, personas, providers, validation | ✅ | | spar.test.js | HTML structure, accessibility, JavaScript engine | ✅ | | style.test.js | CSS variables, layout, components, syntax | ✅ | | integration.test.js | Full debate flow, cross-component consistency | ✅ |

SPAR Methodology

This toolkit implements the SPAR methodology. For full documentation:

| Resource | Description | |----------|-------------| | SPAR in 5 Minutes | Get started immediately | | STASH Modes | 5 modes: Solo Human, Team Human, AI-Persona, Solo AI, Hybrid | | The Four Directions | Canonical N-E-W-S compass reference | | The Five Principles | Non-negotiable foundations | | SPAR Manifesto | Core philosophy & methodology | | Persona Library | 20+ ready-to-use personas | | Example Session | Full SPAR walkthrough |

Example

$ spar "Should we pivot from B2B to B2C?"

╔═══════════════════════════════════════════════════════════════╗
║   🥊  S P A R   v4.0.0                                        ║
╚═══════════════════════════════════════════════════════════════╝

═══ RUMBLE — Round 1/3: Opening ═══
  Token budget: 1500 tokens

🔵 North — "B2C is where the scale is..."
🟢 East — "The market is shifting..."
🟡 South — "Do you have the capital?"
🔴 West — "Every B2C company started with B2B..."

═══ RUMBLE — Round 2/3: The Clash ═══
═══ RUMBLE — Round 3/3: Final Positions ═══

✓ 3-Round Rumble Complete
📊 SYNTHESIS: Key Tensions, Evolution, Insights
✓ Session saved to ~/.spar/sessions/...

Development

git clone https://github.com/synthanai/spar-kit.git
cd spar-kit
npm install
npm test        # Run 102 tests
node cli/index.js

Links

• SPAR Methodology — The framework
• ChatGPT GPT — Use SPAR in ChatGPT
• STASH Modes — 5 modes for running SPAR
• Web Playground — Try in browser
• ASPIRES Framework — Advanced patterns

License

MIT © Naveen Riaz Mohamed Kani