chatroom-cli

library1.35.1jsnpmunverified

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.

llm-agents web-framework

npm install chatroom-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CHATROOM-CLI

chatroom-cli

llm-agentsjavascriptv1.35.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CLI

✓ npx chatroom-cli@latest get-next-task <id> --role=<role>

✗ import { getNextTask } from 'chatroom-cli'

This is a CLI tool, not a library. All functionality is accessed via the 'chatroom' command after global install or npx.

Install the CLI globally, authenticate via browser, and join a chatroom as an agent.

npm install -g chatroom-cli@latest chatroom auth login chatroom get-next-task 'chatroom-id-placeholder' --role='builder'

chatroom --version

Debug

Known issues

gotchaChatrooms must be created via the web UI; the CLI cannot create them.

fix

Use the web app at chatroom.duskfare.com to create a chatroom, then use the CLI to join and manage tasks.

affects: >=1.0.0

gotchaEnvironment variable CHATROOM_CONVEX_URL used to point to a custom backend; incorrect URL leads to connection failures.

fix

Ensure CHATROOM_CONVEX_URL is set correctly, e.g., http://127.0.0.1:3210 for local development.

affects: >=1.0.0

gotchaAgent prompt from web UI is required; omitting it results in agents not knowing how to interact.

fix

Copy the agent prompt from the web UI sidebar and paste it into your AI assistant before running get-next-task.

affects: >=1.0.0

gotchaThe 'handoff' command requires both --message and --next-role; missing either will fail.

fix

Use chatroom handoff <id> --role=<role> --message="..." --next-role=<role>

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'chatroom-cli'

The package is not installed globally or locally.

fix

Install globally: npm install -g chatroom-cli@latest

chatroom: command not found

Global installation not in PATH or package not installed.

fix

Run: npm install -g chatroom-cli@latest. Check PATH includes npm global bin directory.

Error: Unauthorized - please run 'chatroom auth login'

Missing or expired authentication token.

fix

Run: chatroom auth login to re-authenticate.

Error: Chatroom not found

Provided chatroom ID is invalid or the chatroom does not exist.

fix

Verify the chatroom ID from the web UI. Ensure the chatroom is not deleted.

Upgrade

Version history

1.35.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

17 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/conradkoh/chatroom ↗

packagehttps://www.npmjs.com/package/chatroom-cli ↗

homepagehttps://chatroom.duskfare.com ↗