A Claude Code plugin that silently tracks your tasks, orchestrates multi-agent workflows, runs code reviews, QA, and deploys — all through 94 MCP tools. Zero setup, fully local.
npm install -g soloboard
Every kanban board, every Jira ticket, every TODO app — they all demand your attention. SoloBoard is a Claude Code plugin that manages itself.
SoloBoard is a Claude Code plugin powered by MCP. It reads your intent from prompts, tracks file changes via hooks, and links git commits — all silently, right inside your terminal.
"fix the login bug" — Claude understands it's an actionable task and silently creates it on the board in DOING.
Every file Claude writes or edits is automatically linked to the active task. No manual bookkeeping.
When you commit, the SHA is auto-linked to whatever task is in DOING. Branch names and PRs too.
Type /soloboard-board to see your kanban. Or don't — it's there when you need it.
Actionable prompts become tasks. Questions don't. The AI understands the difference.
Commits, branches, and PRs automatically link to tasks. Every task knows its git history.
Say "move login bug to done" — SoloBoard finds "Fix login authentication bug" by fuzzy match.
Each task is a JSON file. No database, no in-memory state, no corruption. Git-friendly.
One install command. Board auto-initializes on first prompt. No setup ceremony.
Only touches your project's .kanban/ directory. No network, no dangerous ops. Just files.
Automatic: timer starts when task enters DOING, stops when it leaves. Per-task and total reports.
See all projects at a glance — task counts, active tasks, and total time across everything.
Export your board as clean markdown with checkboxes, priorities, and git details for reports.
npm install -g soloboard then soloboard install in any project. Done.
Analyzes your project to find related files, auto-tags tasks, sets priority from keywords and git hotspots.
Saves what you looked at, decisions made, and remaining work. Resume any task with full context intact.
Auto-generates .claude/agents/ files for tasks. Launch in any session with full context preloaded.
Pre-close analysis: checks for TODOs, verifies tests exist, counts changes, and flags issues.
Set blocked-by relationships between tasks with automatic circular dependency detection.
Break complex tasks into subtasks. Track progress with completion percentages.
Time-boxed sprints with burndown tracking. Carry over incomplete tasks automatically.
Auto-generated summary: what was done, what's in progress, what's blocked, velocity stats.
Focus sessions tied to tasks. Start a 25-min timer, track progress, stay in flow.
Find the longest dependency chain — the bottleneck determining your project's minimum time.
Text-based timeline view showing task scheduling, parallelism, and dependencies.
Project health score, stall detection, smart suggestions, and automatic reprioritization.
Three columns. That's it. TODO, DOING, DONE. Each task tracks priority, tags, files, commits, and branch.
One script, five things. All reversible.
Adds SoloBoard MCP server
so Claude Code can call
the 94 board tools.
Injects agent instructions: auto-track tasks, stay silent, respond to /soloboard-*
Hooks for: - File change tracking - Git commit linking - Session management
boards/ → project boards tasks/ → one file per task sprints/ → sprint definitions agents/ → v1.5 agent sessions handoffs/ → v1.5 context transfers locks/ → v1.5 file locks history/ → v2.0 completion records velocity/ → v2.0 velocity snapshots approvals/ → v3.0 approval requests reviews/ → v3.0 code reviews qa/ → v3.0 test results deployments/ → v3.0 deploy records team/ → v3.0 team members
All tools are called by Claude Code automatically via MCP. You never need to call them yourself.
| Tool | What it does |
|---|---|
| Initialization | |
| auto_init | Creates .kanban, project, and session in one call. Idempotent. |
| board_summary | One-line status: "TODO: 3 | DOING: 1 | DONE: 5" |
| Smart Tasks | |
| task_smart_create | Smart creation: auto-analyzes project, finds related files, sets priority & tags |
| task_create | Create task with title, priority, tags, and initial status |
| task_update | Update any task field (description, priority, tags, branch, PR) |
| task_get | Get full task details by ID or fuzzy name match |
| task_list | List all tasks, optionally filtered by status |
| task_move | Move task between TODO / DOING / DONE (auto-tracks time) |
| task_delete | Archive or permanently delete a task |
| task_prioritize | Change priority + auto-sort column (high floats to top) |
| task_time | Time tracking report — per task or all tasks |
| task_analyze | Deep analysis: related files, git history, tests, suggested approach |
| Context & Agents | |
| task_context_save | Save context snapshot: files viewed, decisions, remaining work |
| task_context_load | Load context when resuming a task — full continuity |
| task_agent_create | Generate .claude/agents/ file for a task with full context |
| task_agent_delete | Clean up agent file when task is done |
| task_review | Pre-close analysis: TODOs, tests, changes, type check |
| Dependencies | |
| task_depend | Add/remove dependency between tasks (with cycle detection) |
| task_blockers | Show dependency graph — what blocks what |
| critical_path | Find the longest dependency chain (project bottleneck) |
| Subtasks | |
| task_split | Break a task into subtasks with progress tracking |
| task_subtasks | View subtask progress with completion percentage |
| Sprints & Focus | |
| sprint_create | Create a time-boxed sprint (planning or active) |
| sprint_add | Add tasks to a sprint |
| sprint_close | Close sprint, optionally carry over incomplete tasks |
| sprint_view | Sprint progress with burndown bar |
| standup | Daily standup: done, in-progress, blocked, up next |
| pomodoro_start | Start a focus session tied to a task |
| pomodoro_status | Check pomodoro timer with progress bar |
| Auto-Manager | |
| manager_report | Project health score, velocity, stalls, recommendations |
| stall_detect | Find tasks with no recent activity |
| suggest_next | AI-powered "what to work on next" with scoring |
| auto_reprioritize | Smart priority adjustment based on blockers & progress |
| gantt_view | Text-based Gantt chart with dependency visualization |
| Board & Export | |
| board_view | Full kanban board sorted by priority, with time tracking |
| board_export | Export board as clean markdown for reports |
| dashboard | Multi-project overview with task counts and time totals |
| project_create | Create a new project board |
| project_list | List all projects with task counts |
| project_switch | Switch active project by name or ID |
| Session & Git | |
| session_log | Log file changes and commits to current session |
| session_summary | Summary: tasks created, completed, commits, files |
| git_link | Link commit SHA, branch, or PR URL to a task |
| git_status | Git branch, status, and recent commits |
| v1.5: Multi-Agent Orchestration | |
| agent_register | Register an agent session for multi-agent work |
| agent_heartbeat | Update heartbeat, clean stale agents (>5min) |
| agent_list | List active agents with tasks and locked files |
| agent_claim_task | Assign task to agent (fails if already claimed) |
| conflict_check | Check if files are 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 from previous agent |
| parallel_plan | Analyze dependency graph, suggest parallelizable batches |
| v2.0: Planning & Prediction | |
| plan_from_prompt | Natural language → structured task breakdown with deps |
| plan_apply | Bulk-create tasks from plan, set dependencies |
| plan_templates | Pre-built templates: SaaS, API, CLI, library |
| predict_duration | Predict task time from historical similar tasks |
| velocity_report | Tasks/day trends, sprint projection |
| burndown_data | ASCII burndown chart for sprint |
| record_velocity | Snapshot daily velocity |
| v2.0: Risk & Complexity | |
| risk_assess | Git hotspots + deps + complexity → risk level |
| risk_report | All tasks ranked by risk with mitigations |
| complexity_classify | Auto-classify: trivial / small / medium / large / epic |
| v2.0: External Sync | |
| sync_setup | Configure GitHub / Linear / Jira credentials |
| sync_push | Push task to external tool as issue |
| sync_pull | Import issues from external tool into tasks |
| sync_update | Sync status changes bidirectionally |
| sync_status | Show sync state for all linked tasks |
| v2.0: Pull Requests | |
| pr_create | Branch + push + PR + link to task |
| pr_status | Check PR review / CI / merge status |
| pr_auto_flow | Full flow: branch → commit → push → PR → link |
| v3.0: Approvals | |
| approval_request | Create approval request for human review |
| approval_list | List pending approval requests |
| approval_resolve | Approve or reject with reason |
| v3.0: Code Review | |
| review_run | Analyze files: TODOs, type errors, security issues |
| review_findings | View detailed review findings |
| review_respond | Respond: fixed / wont_fix / acknowledged |
| v3.0: QA & Testing | |
| qa_run | Run tests, parse results, create bug tasks for failures |
| qa_report | View QA results |
| qa_rerun | Re-run after fixes, compare with previous run |
| qa_coverage | Check test file coverage for changed files |
| v3.0: DevOps | |
| deploy_check | Readiness check: all done, reviewed, QA passed |
| deploy_run | Execute deployment (approval required for production) |
| deploy_status | Deployment history and status |
| v3.0: Tech Lead | |
| lead_distribute | Distribute tasks to agents by deps/complexity/skills |
| lead_status | Dashboard: agents, tasks, pipeline progress |
| lead_reassign | Reassign task with handoff context |
| lead_pipeline | Full pipeline: coding → review → QA → deploy |
| v3.0: Team Management | |
| team_add | Add team member with role and skills |
| team_list | List members with stats and assignments |
| team_assign | Assign task to team member |
| team_workload | Workload distribution view with chart |
| team_suggest_assignment | Auto-suggest best member by skills/availability |
Everything else is automatic. These are for when you want to see or control the board.
See all tasks organized in TODO, DOING, and DONE columns with priorities and tags.
Show active task, mark as done, create new tasks, or get task details by name.
Create projects, list all boards, or switch between projects.
SoloBoard is just getting started. Here's what we're building.