splitflowai
v0.1.2
Published
MCP server for smart session management. Breaks features into tickets and runs each in a fresh Claude Code session.
Downloads
334
Maintainers
Readme
Splitflow
MCP server that gives Claude Code the ability to break features into tickets and run each in a fresh background session. Your session becomes a control panel.
The Problem
When you ask Claude Code to build a big feature, everything happens in one session. Context accumulates, quality drops by subtask 6-7, and you don't know why.
The Solution
Splitflow breaks your feature into tickets and runs each in a separate Claude Code session with fresh context. You stay in control — skip tickets, give feedback, pause/resume — without leaving your terminal.
Install
npx splitflowai setupThat's it. One command. Auto-detects your agents (Claude Code, Codex) and registers Splitflow with all of them.
Usage
Just talk to Claude Code normally:
You: add a payment system with stripe — checkout, webhooks, email receiptsClaude automatically uses Splitflow to:
- Break it into focused tickets
- Run each in a fresh background session
- Report progress as tickets complete
- Auto-commit each ticket's work
Check progress
You: how's it going?Give feedback
You: for the checkout page, use shadcn componentsSkip, add, or reorder
You: skip the email receipts ticket, I'll do that myselfNext day
You: what did I work on yesterday?MCP Tools
| Tool | What it does |
|------|-------------|
| plan_feature | Break a feature into ordered tickets using AI |
| execute_plan | Run tickets in fresh background Claude Code sessions |
| get_status | Check progress — which ticket is running, what's done |
| add_ticket | Add a new ticket to an existing plan |
| skip_ticket | Skip a ticket |
| apply_feedback | Apply changes to a completed or pending ticket |
| get_history | See all features worked on in this project |
| pause_execution | Pause after the current ticket finishes |
| resume_execution | Resume from the next pending ticket |
How It Works
┌─────────────────────────────────┐
│ Your Claude Code session │
│ (lightweight control panel) │
└──────────────┬──────────────────┘
│ MCP
▼
┌─────────────────────────────────┐
│ Splitflow MCP Server │
│ Plans → Executes → Tracks │
└──────────────┬──────────────────┘
│ Spawns
▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Ticket 1 │ │ Ticket 2 │ │ Ticket 3 │
│ Fresh ctx│ │ Fresh ctx│ │ Fresh ctx│
└──────────┘ └──────────┘ └──────────┘Each ticket runs in an independent claude -p session with only the context it needs.
Requirements
- Claude Code CLI installed
ANTHROPIC_API_KEYset (for ticket planning)- Node.js >= 18
License
MIT
