CrowdListen Kanban

Connect any coding agent to a kanban board. One command to set up. Works with Claude Code, Cursor, Gemini CLI, Codex, Amp, and more.

Setup

npx @crowdlisten/kanban login

That's it. Your browser opens, you sign in to CrowdListen (email, Google, whatever you use), and it auto-configures any coding agents on your machine. Just restart your agent.

No env vars. No JSON to copy. No API keys.

How it works

1. Your browser opens to CrowdListen's sign-in page
2. You log in (email/password or Google)
3. The CLI auto-detects and configures your coding agents
4. Restart your agent — it can now see your kanban board and work on tasks

What your agent can do

All tasks go to one global board by default. No need to manage projects or boards.

| Tool | Description | |------|-------------| | list_tasks | List your tasks (uses global board) | | create_task | Add a new task (optionally tag with project_id) | | get_task | Full task details | | update_task | Change title/description/status/priority | | claim_task | Start working — auto-moves to "In Progress" | | complete_task | Mark done with a summary | | log_progress | Log progress notes | | delete_task | Remove a task | | get_or_create_global_board | Get your global board (auto-created) | | list_projects | Show your projects (for tagging) |

Example

Tell your coding agent:

"Create a task to fix the login bug"

create_task(title: "Fix login bug")
→ { task_id: "xxx", status: "created" }

"Show me my todo tasks"

list_tasks(status: "todo")
→ { tasks: [...], count: 5 }

"Claim the top task and start working"

claim_task(task_id: "xxx")
→ { status: "claimed", branch: "task/fix-login-bug-xxx" }

Supported agents

Auto-configured on login:

• Claude Code (~/.claude.json)
• Cursor (.cursor/mcp.json)
• Gemini CLI (~/.gemini/settings.json)
• Codex (~/.codex/config.json)
• Amp (~/.amp/settings.json)

Also works with (manual config):

• OpenClaw, Vibe Kanban, Copilot, Droid, Qwen Code, OpenCode

The server auto-detects which agent is running and logs it.

Manual configuration

If auto-configure doesn't work, add this to your agent's MCP config:

{
  "mcpServers": {
    "crowdlisten_tasks": {
      "command": "npx",
      "args": ["-y", "@crowdlisten/kanban"]
    }
  }
}

Commands

npx @crowdlisten/kanban login    # Sign in + auto-configure agents
npx @crowdlisten/kanban setup    # Re-run auto-configure
npx @crowdlisten/kanban logout   # Clear credentials
npx @crowdlisten/kanban whoami   # Check current user

Multi-user

Each person logs in with their own CrowdListen account. Row-level security means they only see their own data. Multiple users can work on shared projects simultaneously.

Development

git clone https://github.com/Crowdlisten/crowdlisten_tasks.git
cd crowdlisten_tasks
npm install
npm run build
npm run dev     # Run with tsx
npm test        # Vitest

Troubleshooting

"command not found" on first run?

npm cache clean --force && npx --yes @crowdlisten/kanban@latest login

Contributing

Issues and PRs welcome. This is part of the CrowdListen open source ecosystem — see also crowdlisten_sources for social media extraction.

License

MIT