CrowdListen Agent CLI

Connect your local coding agent (Claude Code, Codex, OpenCode) to CrowdListen's Kanban board. Tasks assigned in the web UI get picked up by your local machine and results stream back in real-time.

Prerequisites

• Node.js ≥ 18
• A coding agent installed locally:
  • Claude Code (claude CLI) — recommended
  • Codex (codex CLI)
  • OpenCode (opencode CLI)
• A CrowdListen account

Quick Start

cd agent-bridge
npm install

# Connect (opens browser to sign in)
node cli.js connect

That's it. Your browser opens, you sign in to CrowdListen (or it auto-detects if you're already signed in), and the CLI starts listening for tasks.

What Happens

1. Browser opens → CrowdListen sign-in page (Google or email/password)
2. You sign in → browser shows "Connected!" and you can close the tab
3. CLI registers → your machine appears as an available agent in CrowdListen
4. Tasks arrive → when you assign a task on the Kanban board, the CLI picks it up automatically
5. Agent executes → Claude Code / Codex runs the task locally
6. Results stream → output appears in real-time in the web UI

Subsequent runs skip the browser — your session is cached in ~/.crowdlisten-agent.json.

Commands

node cli.js connect                  # Connect and wait for tasks
node cli.js connect --executor codex # Use Codex instead of Claude
node cli.js connect --name "my-pc"   # Custom agent name
node cli.js connect --project /path  # Set working directory for agent
node cli.js status                   # Check if you're connected
node cli.js disconnect               # Go offline

Options

| Flag | Description | Default | |------|-------------|---------| | --executor <name> | Coding agent: claude, codex, opencode | claude | | --name <name> | Display name for this agent | Machine hostname | | --project <path> | Working directory for the coding agent | Current directory |

Architecture

Web UI (Kanban) ──→ Supabase (agent_tasks) ──→ CLI (Realtime subscription)
                                                    │
                                                    ├─→ Spawns coding agent
                                                    │
                                                    └─→ Streams logs back ──→ Web UI

• No server needed — CLI connects directly to Supabase
• Secure — authenticated with your account, RLS ensures you only see your tasks
• Real-time — Supabase Realtime for instant task delivery and live log streaming

Troubleshooting

Browser didn't open — The CLI prints the URL. Copy-paste it into your browser manually.

"Session expired" — Just run connect again, it'll re-open the browser.

"claude: command not found" — Install it: npm install -g @anthropic-ai/claude-code

Agent not showing online — Run node cli.js status to check. Re-run connect if needed.