{"_id":"@andupetcu/agentboard","_rev":"2-acc079d6aae56d57b2f038475a3d3315","name":"@andupetcu/agentboard","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@andupetcu/agentboard","version":"0.1.0","keywords":["ai","agents","tasks","kanban","cli","mcp","sqlite"],"author":{"name":"Andrei Petcu"},"license":"MIT","_id":"@andupetcu/agentboard@0.1.0","maintainers":[{"name":"andupetcu","email":"andrei@cloudz.ro"}],"homepage":"https://github.com/andupetcu/agentboard#readme","bugs":{"url":"https://github.com/andupetcu/agentboard/issues"},"bin":{"agentboard":"dist/cli.js","agentboard-mcp":"dist/mcp/server.js"},"dist":{"shasum":"890b526607d8791ac1762f20f3b24ae6d8b1af79","tarball":"https://registry.npmjs.org/@andupetcu/agentboard/-/agentboard-0.1.0.tgz","fileCount":74,"integrity":"sha512-bKa0Q+sYMjEOZYzDvnQlcK2Ndgjol7RuxHCT5Eqnlywj5ym94BeIlWkumDpIt+xot8U6ADLOxUotXQxMQ5NNjQ==","signatures":[{"sig":"MEUCIFbBMIXgP+V8yILl9ZpV+gNI5lcxcXC0Jn35QHSYeO24AiEA3sIJ6UktEEkPVRscx6BZ7Ss2tqi3k7D1ReifHSY4IXU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137412},"main":"dist/cli.js","type":"module","types":"./dist/cli.d.ts","gitHead":"b0670a0b267a612ee4e15b6f2e73688eed685fec","scripts":{"dev":"tsx src/cli.ts","test":"vitest run","build":"tsc"},"_npmUser":{"name":"andupetcu","email":"andrei@cloudz.ro"},"repository":{"url":"git+https://github.com/andupetcu/agentboard.git","type":"git"},"_npmVersion":"11.9.0","description":"CLI task management for AI agents — kanban board with MCP support","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^4.3.6","chalk":"^5.4.1","commander":"^13.1.0","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","vitest":"^3.0.6","typescript":"^5.7.3","@types/node":"^22.13.4","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/agentboard_0.1.0_1772524005931_0.8415444251222544","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@andupetcu/agentboard","version":"0.1.1","description":"CLI task management for AI agents — kanban board with MCP support","type":"module","main":"dist/cli.js","license":"MIT","repository":{"type":"git","url":"git+https://github.com/andupetcu/agentboard.git"},"keywords":["ai","agents","tasks","kanban","cli","mcp","sqlite"],"author":{"name":"Andrei Petcu"},"bin":{"agentboard":"dist/cli.js","agentboard-mcp":"dist/mcp/server.js"},"scripts":{"build":"tsc && mkdir -p dist/web && cp src/web/ui.html dist/web/ui.html","test":"vitest run","dev":"tsx src/cli.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","better-sqlite3":"^11.7.0","chalk":"^5.4.1","commander":"^13.1.0","express":"^5.2.1","zod":"^4.3.6"},"devDependencies":{"@types/better-sqlite3":"^7.6.12","@types/express":"^5.0.6","@types/node":"^22.13.4","tsx":"^4.19.3","typescript":"^5.7.3","vitest":"^3.0.6"},"_id":"@andupetcu/agentboard@0.1.1","gitHead":"c33a3309aae90e1db555d2558bbf32def63d12bf","types":"./dist/cli.d.ts","bugs":{"url":"https://github.com/andupetcu/agentboard/issues"},"homepage":"https://github.com/andupetcu/agentboard#readme","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-Zq1j+zKm0g31bXc2Lmw/AvFS/wiK2oxIdfzSNm6rsh906F7uyD7TQBf8QkjUOP1cmycWzFpbuDruuww4Ii2afQ==","shasum":"5ce546cf6adf95d727a0e36331ad1af3143ce6be","tarball":"https://registry.npmjs.org/@andupetcu/agentboard/-/agentboard-0.1.1.tgz","fileCount":108,"unpackedSize":247384,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDsCMFEurpyIelOanA7Mm/2bR9iYbwMlgn1tdBJ9Y8qnAiEA3w5BsS6zR73iAOoAjuHt3cCmDjizURZ7b+p1lHuGLOQ="}]},"_npmUser":{"name":"andupetcu","email":"andrei@cloudz.ro"},"directories":{},"maintainers":[{"name":"andupetcu","email":"andrei@cloudz.ro"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentboard_0.1.1_1772545887536_0.4099728440906185"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-03T07:46:45.844Z","modified":"2026-03-03T13:51:27.821Z","0.1.0":"2026-03-03T07:46:46.087Z","0.1.1":"2026-03-03T13:51:27.709Z"},"bugs":{"url":"https://github.com/andupetcu/agentboard/issues"},"author":{"name":"Andrei Petcu"},"license":"MIT","homepage":"https://github.com/andupetcu/agentboard#readme","keywords":["ai","agents","tasks","kanban","cli","mcp","sqlite"],"repository":{"type":"git","url":"git+https://github.com/andupetcu/agentboard.git"},"description":"CLI task management for AI agents — kanban board with MCP support","maintainers":[{"name":"andupetcu","email":"andrei@cloudz.ro"}],"readme":"# AgentBoard\n\nCLI task management for AI agents. A kanban board that agents can use programmatically.\n\n```\n📋 AgentBoard — 2 projects, 5 tasks\n\n  brandfetch (3 tasks)\n  ├─ 🔴 P0 [ab-001] Deploy API              kai    🔄 IN_PROGRESS  2h ago\n  │  └─ 🔵 P2 [ab-002] Write migrations      kai    📋 TODO\n  └─ 🟡 P1 [ab-003] Add pricing page         —      📋 TODO\n\n  cleanprompts (2 tasks)\n  └─ 🟡 P1 [ab-004] Bias detection pillar    —      📋 TODO\n```\n\n## Why\n\nAI agents (Claude Code, Codex, OpenClaw) need a way to coordinate work. AgentBoard gives them a shared task board — SQLite-backed, zero config, CLI-first.\n\n- **No server** — single SQLite file at `~/.agentboard/board.db`\n- **No setup** — `npx @andupetcu/agentboard add \"Do the thing\"` and you're running\n- **MCP support** — 15 tools exposed via stdio for Claude Code / Codex integration\n- **Sub-50ms** — every operation is fast\n\n## Install\n\n```bash\nnpm install -g @andupetcu/agentboard\n```\n\nOr use directly:\n\n```bash\nnpx @andupetcu/agentboard\n```\n\n## Quick Start\n\n```bash\n# Create a task\nagentboard add \"Build REST API\" --project myapp --priority p0 --assign claude\n\n# View the board\nagentboard board\n\n# Start working\nagentboard start ab-001\n\n# Add progress notes\nagentboard comment ab-001 \"Endpoints done, writing tests\"\n\n# Mark complete\nagentboard done ab-001 \"All endpoints + tests passing\"\n```\n\n## Commands\n\n### Tasks\n\n| Command | Description |\n|---------|-------------|\n| `add <title>` | Create a task (`--project`, `--priority`, `--assign`, `--parent`, `--tags`, `--due`) |\n| `list` | List tasks (`--status`, `--project`, `--assigned`, `--stale`, `--tree`, `--json`) |\n| `show <id>` | Full task details + event log |\n| `update <id>` | Update fields (`--status`, `--priority`, `--title`, `--assign`) |\n| `start <id>` | Set status to in_progress |\n| `done <id> [summary]` | Mark complete |\n| `block <id> <reason>` | Block with reason |\n| `unblock <id>` | Resume blocked task |\n| `cancel <id> [reason]` | Cancel task |\n| `comment <id> <text>` | Add a progress note |\n\n### Views\n\n| Command | Description |\n|---------|-------------|\n| `board` | Kanban view grouped by project (`--project` to filter) |\n| `summary` | Quick stats (total, by status, by project) |\n| `stale` | Tasks with no updates past their threshold |\n| `timeline <id>` | Full event log for a task |\n\n### Agents\n\n| Command | Description |\n|---------|-------------|\n| `agent register <id>` | Register an agent (`--type`, `--capabilities`) |\n| `agent heartbeat <id>` | Update last_seen timestamp |\n| `agent list` | List all agents |\n| `agent health` | Status check (active / idle / dead) |\n\n## MCP Server\n\nAgentBoard includes an MCP server for AI agent integration:\n\n```bash\nagentboard-mcp\n```\n\nThis exposes all 15 operations as MCP tools over stdio. Add to your Claude Code or Codex MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentboard\": {\n      \"command\": \"agentboard-mcp\"\n    }\n  }\n}\n```\n\n### Available Tools\n\n`task_add`, `task_list`, `task_show`, `task_update`, `task_start`, `task_done`, `task_block`, `task_unblock`, `task_cancel`, `task_comment`, `board`, `summary`, `agent_register`, `agent_heartbeat`, `agent_health`\n\n## Task IDs\n\nSequential, human-readable: `ab-001`, `ab-002`, etc. Customize the prefix with `AGENTBOARD_PREFIX` env var.\n\n## Priorities\n\n| Level | Label | Icon |\n|-------|-------|------|\n| `p0` | Critical | 🔴 |\n| `p1` | High | 🟡 |\n| `p2` | Medium (default) | 🔵 |\n| `p3` | Low | ⚪ |\n\n## Status Flow\n\n```\ntodo → in_progress → done\n     → blocked → in_progress\n     → cancelled\n```\n\n## Configuration\n\n| Env Var | Default | Description |\n|---------|---------|-------------|\n| `AGENTBOARD_DB` | `~/.agentboard/board.db` | Database path |\n| `AGENTBOARD_PREFIX` | `ab` | Task ID prefix |\n\n## Stack\n\nTypeScript, SQLite (better-sqlite3), Commander, Chalk. ~2,000 lines, 59 tests.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}