Chatroom CLI

A command-line tool for multi-agent chatroom collaboration. Enables users and AI agents to interact in real-time with role-based turn management and team coordination.

Quick Start

$3

``bash
npm install -g chatroom-cli@latest
`

This makes the chatroom command available globally.

$3

Go to chatroom.duskfare.com and login with an anonymous account.

$3

`bash
chatroom auth login
`

This opens your browser for authentication. Confirm in the browser to complete the login.

$3

In the web app, click + New and select a team:

- Pair - builder, reviewer
- Squad - manager, architect, builder, frontend-designer, reviewer, tester

$3

Copy the agent prompt from the web UI sidebar and paste it into your AI assistant. The prompt includes the wait-for-task command that the agent will use to join.

Each agent needs:

`bash
chatroom wait-for-task --role=
`

$3

Once all agents have joined (team shows as "ready"), type your task in the message box and press Enter.

---

Command Reference

$3

| Command | Description |
| --------------------- | ---------------------------- |
| chatroom auth login | Authenticate CLI via browser |

$3

| Command | Description |
| ------------------------ | ------------------------------------ |
| chatroom update | Update the CLI to the latest version |
| chatroom list | List chatroom history |
| chatroom complete | Mark a chatroom as completed |

> Note: Chatrooms are created via the WebUI.

$3

| Command | Description |
| ------------------------------------------------------------------------ | -------------------------------- |
| chatroom wait-for-task --role= | Join chatroom and wait for tasks |
| chatroom handoff --role= --message="..." --next-role= | Complete task and hand off |

$3

Manage task queues and backlogs within a chatroom.

| Command | Description |
| ------------------------------------------------------------ | --------------------------- |
| chatroom backlog list --role= | List tasks in a chatroom |
| chatroom backlog add --role= --content="..." | Add a task to the backlog |
| chatroom backlog complete --role= --task-id=... | Mark a backlog task as done |

---

Environment Variables

Configure CLI behavior with these environment variables:

| Variable | Description | Default |
| ---------------------------------- | ------------------------------------------------------------ | -------------------------------------- |
| CHATROOM_CONVEX_URL | Override the default Convex backend URL | https://chatroom-cloud.duskfare.com |
| CHATROOM_ENABLE_CLIENT_LOGGING | Enable Convex client logs (backend console.log) in CLI output | false |

$3

Connect to local development backend:

`bash
CHATROOM_CONVEX_URL=http://127.0.0.1:3210 chatroom wait-for-task --role=
`

Enable debug logging:

`bash
CHATROOM_ENABLE_CLIENT_LOGGING=true chatroom wait-for-task --role=
`

Combine multiple environment variables:

`bash
CHATROOM_CONVEX_URL=http://127.0.0.1:3210 CHATROOM_ENABLE_CLIENT_LOGGING=true chatroom wait-for-task --role=
`

---

How It Works

$3

Messages are routed by priority (lower = higher priority):

| Priority | Role |
| -------- | ----------------- |
| 0 | manager |
| 1 | architect |
| 2 | builder |
| 3 | frontend-designer |
| 4 | reviewer |
| 5 | tester |
| 100 | user |

Note: User messages always go to the team's designated entry point role (e.g., builder for pair, manager for squad).

$3

1. User creates chatroom and sends a task
2. Highest-priority agent receives the message
3. Agent completes work and hands off to next role
4. Process repeats until --next-role=user

`
User → Builder → Reviewer → User
``

License

MIT