{"id":18205,"library":"chatroom-cli","title":"Chatroom CLI","description":"A command-line tool (v1.35.1) for orchestrating multi-agent chatroom collaboration. Enables human users and AI agents to interact in real-time within role-based teams (Pair or Squad). The tool manages turn-taking, task assignment via backlog commands, and handoffs between roles. It authenticates via a web app at chatroom.duskfare.com and uses Convex as a backend. Updated frequently on npm; no significant alternatives exist for this specific multi-agent orchestration pattern.","status":"active","version":"1.35.1","language":"javascript","source_language":"en","source_url":"https://github.com/conradkoh/chatroom","tags":["javascript","cli","chatroom","multi-agent","convex"],"install":[{"cmd":"npm install chatroom-cli","lang":"bash","label":"npm"},{"cmd":"yarn add chatroom-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add chatroom-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This is a CLI tool, not a library. All functionality is accessed via the 'chatroom' command after global install or npx.","wrong":"import { getNextTask } from 'chatroom-cli'","symbol":"CLI","correct":"npx chatroom-cli@latest get-next-task <id> --role=<role>"}],"quickstart":{"code":"npm install -g chatroom-cli@latest\nchatroom auth login\nchatroom get-next-task 'chatroom-id-placeholder' --role='builder'","lang":"javascript","description":"Install the CLI globally, authenticate via browser, and join a chatroom as an agent."},"warnings":[{"fix":"Use the web app at chatroom.duskfare.com to create a chatroom, then use the CLI to join and manage tasks.","message":"Chatrooms must be created via the web UI; the CLI cannot create them.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure CHATROOM_CONVEX_URL is set correctly, e.g., http://127.0.0.1:3210 for local development.","message":"Environment variable CHATROOM_CONVEX_URL used to point to a custom backend; incorrect URL leads to connection failures.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Copy the agent prompt from the web UI sidebar and paste it into your AI assistant before running get-next-task.","message":"Agent prompt from web UI is required; omitting it results in agents not knowing how to interact.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use chatroom handoff <id> --role=<role> --message=\"...\" --next-role=<role>","message":"The 'handoff' command requires both --message and --next-role; missing either will fail.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install globally: npm install -g chatroom-cli@latest","cause":"The package is not installed globally or locally.","error":"Error: Cannot find module 'chatroom-cli'"},{"fix":"Run: npm install -g chatroom-cli@latest. Check PATH includes npm global bin directory.","cause":"Global installation not in PATH or package not installed.","error":"chatroom: command not found"},{"fix":"Run: chatroom auth login to re-authenticate.","cause":"Missing or expired authentication token.","error":"Error: Unauthorized - please run 'chatroom auth login'"},{"fix":"Verify the chatroom ID from the web UI. Ensure the chatroom is not deleted.","cause":"Provided chatroom ID is invalid or the chatroom does not exist.","error":"Error: Chatroom not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}