SoloBoard

Autonomous development orchestrator for Claude Code
From invisible kanban to autonomous dev team. 94 tools.

---

What is this?

SoloBoard is a Claude Code plugin that silently tracks your tasks as you work. No setup commands, no context switching, no overhead. Just code — the board manages itself.

you > fix the login bug on mobile
                                    ← task silently created in DOING

claude > Found the issue in auth.ts:47...
                                    ← files auto-tracked to task

you > commit this
                                    ← commit SHA auto-linked to task

you > /soloboard-board

  TODO (1)       DOING (1)              DONE (3)
                 → Fix login bug        ✓ Setup auth
                   on mobile            ✓ Add dark mode
                   abc1234              ✓ Refactor API

Install

Option A: npm global (recommended)

npm install -g soloboard
soloboard install            # in your project directory

Option B: Clone & build

git clone https://github.com/egorfedorov/Soloboard.git
cd Soloboard && npm install && npm run build
bash install.sh /path/to/your/project

Then just cd your-project && claude — the board manages itself.

Getting Started

See the Getting Started Guide for a complete walkthrough — installation, first use, common workflows, and troubleshooting.

How it works

You do	SoloBoard does (silently)
"fix the login bug"	Creates task → DOING
"how does auth work?"	Nothing — it's a question
"add dark mode"	Moves previous task → TODO, creates new → DOING
Edit files	Auto-tracks changed files to active task
git commit	Auto-links commit SHA to active task
/soloboard-board	Shows the kanban board
/soloboard-task done	Moves active task → DONE

Commands

Command	What it does
/soloboard-board	View your kanban board
/soloboard-task	Show active task / done / create <title> / delete <name>
/soloboard-project	Show project / create <name> / list / switch <name>

Features

• Zero friction — no setup commands, board auto-initializes on first prompt
• Silent tracking — tasks created from actionable prompts, questions ignored
• Smart task creation — analyzes project to find related files, auto-tags, and sets priority
• Task context — saves what you examined, decisions made, remaining work per task
• Task agents — auto-generates .claude/agents/ files for complex tasks
• Auto-review — pre-close analysis checks for TODOs, tests, type errors before marking done
• Task splitting — break complex tasks into subtasks with progress tracking
• Dependencies — blocked-by relationships with circular dependency detection
• Critical path — find the bottleneck chain that determines project duration
• Sprints — time-boxed task grouping with burndown tracking
• Daily standup — automated standup summary: done, in-progress, blocked
• Pomodoro timer — focus sessions tied to tasks
• Auto-manager — project health score, stall detection, smart suggestions
• Gantt chart — text-based timeline view with dependency visualization
• Auto-reprioritize — smart priority adjustment based on blockers and progress
• Git integration — commits, branches, and PRs auto-linked to tasks
• Fuzzy search — say "move login bug to done" and it finds the right task
• File-per-task storage — each task is a JSON file in .kanban/tasks/, git-friendly
• Safe — only touches .kanban/ in your project, no network, no dangerous ops
• 3 statuses — TODO, DOING, DONE. That's it.
• Time tracking — automatic: tracks time in DOING, shows per-task and total
• Priority sorting — high tasks float to top of each column automatically
• Markdown export — export the board as markdown for reports or sharing
• Multi-project dashboard — see all projects at a glance with dashboard
• Global CLI — npm install -g soloboard && soloboard install
• Multi-agent orchestration — register agents, claim tasks, lock files, handoff context
• NL planning — describe what you want to build, get a structured task plan
• Predictive estimates — learns from history, predicts task durations
• Risk assessment — git hotspots, dependency depth, complexity scoring
• GitHub/Linear/Jira sync — push/pull issues, bidirectional status sync
• PR auto-flow — branch → commit → push → PR → link to task
• Autonomous code review — finds TODOs, type errors, security issues
• QA automation — run tests, parse results, create bug tasks for failures
• DevOps pipeline — deploy check, run, status with approval gates
• Tech lead mode — distribute tasks to agents by skills and complexity
• Team management — add members with roles, track workload, suggest assignments
• Approval workflow — human-in-the-loop for autonomous decisions
• VSCode extension — visual board in sidebar with live file watching

Architecture

soloboard/
├── src/mcp-server/
│   ├── index.ts              # Entry point (stdio transport)
│   ├── server.ts             # MCP server + 94 tools
│   ├── tools/
│   │   ├── task-tools.ts     # create/update/get/list/move/delete
│   │   ├── board-tools.ts    # view/project-create/list/switch
│   │   ├── session-tools.ts  # log/summary
│   │   ├── git-tools.ts      # link/status
│   │   ├── init-tools.ts     # auto_init/board_summary
│   │   ├── export-tools.ts   # export/dashboard/prioritize/time
│   │   ├── smart-tools.ts    # smart_create/analyze (project analysis)
│   │   ├── context-tools.ts  # context_save/load (task continuity)
│   │   ├── agent-tools.ts    # agent_create/delete (.claude/agents/)
│   │   ├── review-tools.ts   # pre-close review & checklist
│   │   ├── dependency-tools.ts # depend/blockers/critical_path
│   │   ├── subtask-tools.ts  # split/subtasks
│   │   ├── sprint-tools.ts   # create/add/close/view
│   │   ├── standup-tools.ts  # standup/pomodoro
│   │   ├── manager-tools.ts  # report/stall/suggest/reprioritize/gantt
│   │   ├── orchestration-tools.ts  # v1.5: agent register/claim/handoff/lock
│   │   ├── planning-tools.ts       # v2.0: plan from prompt/apply/templates
│   │   ├── prediction-tools.ts     # v2.0: predict/velocity/burndown
│   │   ├── risk-tools.ts           # v2.0: risk assess/report/classify
│   │   ├── sync-tools.ts           # v2.0: GitHub/Linear/Jira sync
│   │   ├── pr-tools.ts             # v2.0: PR create/status/auto-flow
│   │   ├── approval-tools.ts       # v3.0: request/list/resolve
│   │   ├── code-review-tools.ts    # v3.0: review run/findings/respond
│   │   ├── qa-tools.ts             # v3.0: qa run/report/rerun/coverage
│   │   ├── devops-tools.ts         # v3.0: deploy check/run/status
│   │   ├── tech-lead-tools.ts      # v3.0: distribute/status/reassign/pipeline
│   │   └── team-tools.ts           # v3.0: add/list/assign/workload/suggest
│   ├── storage/              # Atomic writes, file-per-task
│   ├── models/               # Task, Board, Session, Sprint, Config + 8 new models
│   └── utils/                # nanoid, git, project analyzer, file-lock, external-sync
├── vscode-extension/         # VSCode sidebar board view
├── scripts/                  # Hook scripts (session, files, commits)
├── commands/                 # Slash command definitions
├── skills/                   # Smart auto-tracking skill
└── install.sh                # One-command installer

Data stored in your project:

.kanban/
├── config.json               # Active project + session
├── boards/{id}.json          # Board columns (task IDs)
├── tasks/{id}.json           # One file per task (with context)
├── sprints/{id}.json         # Sprint definitions
├── archive/{id}.json         # Completed old tasks
├── sessions/{id}.json        # Session logs (gitignored)
├── agents/{id}.json          # v1.5: Agent registrations
├── handoffs/{id}.json        # v1.5: Handoff contexts
├── locks/{hash}.lock.json    # v1.5: File locks
├── history/{id}.json         # v2.0: Completion records
├── velocity/{id}.json        # v2.0: Velocity snapshots
├── approvals/{id}.json       # v3.0: Approval requests
├── reviews/{id}.json         # v3.0: Code reviews
├── qa/{id}.json              # v3.0: QA results
├── deployments/{id}.json     # v3.0: Deployments
└── team/{id}.json            # v3.0: Team members

MCP Tools (94)

Tool	Purpose
Init
auto_init	Initialize board + session (idempotent)
board_summary	One-line status for context injection
Smart Tasks
task_smart_create	Create task with auto-analysis, tags, priority
task_create	Create task with title, priority, tags
task_update	Update task fields
task_get	Get task by ID or fuzzy name
task_list	List tasks, filter by status
task_move	Move between TODO/DOING/DONE
task_delete	Archive or delete task
task_prioritize	Change priority + auto-sort column
task_time	Time tracking report per task or all
task_analyze	Deep project analysis for a task
Context & Agents
task_context_save	Save context: files, decisions, remaining work
task_context_load	Load context when resuming a task
task_agent_create	Generate .claude/agents/ file for a task
task_agent_delete	Clean up agent file when done
task_review	Pre-close: TODOs, tests, changes, type check
Dependencies
task_depend	Add/remove dependency between tasks
task_blockers	Show dependency graph for task or all
critical_path	Find the longest dependency chain (bottleneck)
Subtasks
task_split	Break task into subtasks
task_subtasks	View subtask progress
Sprints
sprint_create	Create a time-boxed sprint
sprint_add	Add tasks to a sprint
sprint_close	Close sprint, optionally carry over incomplete
sprint_view	Sprint progress with burndown
Standup & Focus
standup	Daily standup: done, in-progress, blocked
pomodoro_start	Start a focus session on a task
pomodoro_status	Check pomodoro timer
Auto-Manager
manager_report	Health score, velocity, stalls, suggestions
stall_detect	Find tasks with no recent activity
suggest_next	AI-powered "what to work on next"
auto_reprioritize	Smart priority adjustment (dry run or apply)
gantt_view	Text-based Gantt chart with dependencies
Board & Export
board_view	Full kanban board (sorted by priority)
board_export	Export board as markdown
dashboard	Multi-project overview with time totals
project_create	Create project board
project_list	List all projects
project_switch	Switch active project
Session & Git
session_log	Log file/commit to session
session_summary	Session activity summary
git_link	Link commit/branch/PR to task
git_status	Git repo status + recent commits
v1.5: Multi-Agent
agent_register	Register agent session for multi-agent work
agent_heartbeat	Update heartbeat, clean stale agents
agent_list	List active agents + tasks + locked files
agent_claim_task	Assign task to agent (fails if claimed)
conflict_check	Check if files locked by another agent
file_lock	Lock files to prevent concurrent edits
file_unlock	Release file locks
agent_handoff	Create handoff context + release locks
agent_pickup	Accept handoff, get full context
parallel_plan	Suggest parallelizable task batches
v2.0: Planning
plan_from_prompt	NL description → structured task breakdown
plan_apply	Bulk-create tasks from plan with deps
plan_templates	Pre-built templates: SaaS, API, CLI, library
predict_duration	Predict task time from history
velocity_report	Tasks/day trends, sprint projection
burndown_data	ASCII burndown chart for sprint
record_velocity	Snapshot daily velocity
risk_assess	Git hotspots + deps → risk level
risk_report	All tasks ranked by risk
complexity_classify	Auto-classify trivial → epic
sync_setup	Configure GitHub/Linear/Jira
sync_push	Push task to external tool
sync_pull	Import issues from external
sync_update	Bidirectional status sync
sync_status	Show sync state for linked tasks
pr_create	Branch + push + PR + link
pr_status	Check PR review/CI/merge
pr_auto_flow	Full branch → commit → PR flow
v3.0: Autonomous
approval_request	Create approval for human review
approval_list	List pending approvals
approval_resolve	Approve/reject with reason
review_run	Code review: TODOs, types, security
review_findings	View review findings
review_respond	Respond: fixed/wont_fix/acknowledged
qa_run	Run tests, create bug tasks
qa_report	View QA results
qa_rerun	Re-run, compare with previous
qa_coverage	Test coverage for changed files
deploy_check	Readiness check before deploy
deploy_run	Execute deployment
deploy_status	Deployment history
lead_distribute	Distribute tasks to agents
lead_status	Dashboard: agents, tasks, pipeline
lead_reassign	Reassign with handoff context
lead_pipeline	Coding → review → QA → deploy
team_add	Add team member with skills
team_list	List members with stats
team_assign	Assign task to member
team_workload	Workload distribution
team_suggest_assignment	Auto-suggest by skills/availability

What install.sh does

1. Adds SoloBoard MCP server to .mcp.json
2. Creates hooks in .claude/settings.json (file tracking, commit linking)
3. Injects agent instructions into CLAUDE.md
4. Initializes .kanban/ directory
5. Adds .kanban/sessions/ to .gitignore

All reversible. Delete these files to uninstall.

Dependencies

Only 3 runtime dependencies:

• @modelcontextprotocol/sdk — MCP protocol
• zod — schema validation
• nanoid — ID generation

License

MIT