Soloboard
SoloBoard - Autonomous development orchestrator for Claude Code.
Ask AI about Soloboard
Powered by Claude Β· Grounded in docs
I know everything about Soloboard. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
- Adds SoloBoard MCP server to
.mcp.json - Creates hooks in
.claude/settings.json(file tracking, commit linking) - Injects agent instructions into
CLAUDE.md - Initializes
.kanban/directory - Adds
.kanban/sessions/to.gitignore
All reversible. Delete these files to uninstall.
Dependencies
Only 3 runtime dependencies:
@modelcontextprotocol/sdkβ MCP protocolzodβ schema validationnanoidβ ID generation
License
MIT
