Lightweight task board for coding agents with CLI, web UI, and embedded terminal
npm install agentboardA lightweight desktop task board for coding agents. Track tasks, keep notes, and run embedded terminals.
``bash`
npm install -g agentboard
The postinstall script automatically builds native modules for Electron.
`bash`
agentboard
That's it! The app opens with:
- Task list on the left
- Task details, notes, and terminal on the right
- Per-task embedded terminal sessions
`bash`
agentboard list # List all tasks
agentboard new "Fix the bug" # Create a task
agentboard status 1 doing # Mark task as in progress
agentboard open 1 # Open terminal for task
agentboard --help # Show all commands
`bash`
agentboard mcp # Start MCP stdio server
Add to your agent config:
`json`
{
"mcpServers": {
"agentboard": {
"command": "agentboard",
"args": ["mcp"]
}
}
}
- Task management: Create, update, filter tasks by status/date/text
- Per-task terminals: Each task gets its own shell session
- Per-task notes: Markdown notes stored in ~/.agentboard/tasks/
- Attention flag: Mark tasks that need your attention
- Auto-detection: Detects agent name and project from terminal activity
- MCP integration: Works with Claude and other MCP-compatible agents
- tmux support: Auto-context from active tmux pane
All data is stored locally in ~/.agentboard/:agentboard.db
- - SQLite databasetasks/
- - Task noteslogs/
- - Terminal logs
- Node.js 18+
- tmux (optional, for auto-context)
| Command | Description |
|---------|-------------|
| list | List tasks (filters: --status, --include-done, --query) |show
| | Show task details |new [title]
| | Create a task |status
| | Update status (todo/doing/blocked/done) |attention
| | Toggle attention flag |rename
| | Rename task |notes
| | Show/edit notes (--edit, --set, --append) |open
| | Open task terminal |close
| | Close task terminal |log
| | Open task log file |context
| | Show auto-context |server
| | Start HTTP/WebSocket server |mcp
| | Start MCP stdio server |desktop
| | Launch Electron app |
Native module errors: Run npm rebuild better-sqlite3`
Electron not starting: The desktop app requires Electron. If you only need CLI/web, those work without Electron.
MIT