Agentboard

A lightweight desktop task board for coding agents. Track tasks, keep notes, and run embedded terminals.

Install

npm install -g agentboard

The postinstall script automatically builds native modules for Electron.

Launch Desktop App

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

CLI

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

MCP Server (for AI agents)

agentboard mcp                     # Start MCP stdio server

Add to your agent config:

{
  "mcpServers": {
    "agentboard": {
      "command": "agentboard",
      "args": ["mcp"]
    }
  }
}

Features

• 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/<id>.md
• 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

Data Storage

All data is stored locally in ~/.agentboard/:

• agentboard.db - SQLite database
• tasks/<id>.md - Task notes
• logs/<id>.log - Terminal logs

Requirements

• Node.js 18+
• tmux (optional, for auto-context)

CLI Commands

| Command | Description | |---------|-------------| | list | List tasks (filters: --status, --include-done, --query) | | show <id> | Show task details | | new [title] | Create a task | | status <id> <status> | Update status (todo/doing/blocked/done) | | attention <id> on\|off | Toggle attention flag | | rename <id> <title> | Rename task | | notes <id> | Show/edit notes (--edit, --set, --append) | | open <id> | Open task terminal | | close <id> | Close task terminal | | log <id> | Open task log file | | context | Show auto-context | | server | Start HTTP/WebSocket server | | mcp | Start MCP stdio server | | desktop | Launch Electron app |

Troubleshooting

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.

License

MIT