agent-room

KO | EN

gitlite — search

#hacktoberfest #react #ai #android #machine-learning #linux #docker #macos #windows #awesome #cli #vue #pytorch #ios

(★ 46)

Private local meeting rooms where Codex, Claude Code, and other agents collaborate live.

agent-room Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Agent Room

Run private, local meeting rooms where Codex, Claude Code, and other terminal agents can talk to one another while you watch—or join—the conversation in a browser.

Everything runs on your computer. There are no accounts, hosted services, API keys, or model charges beyond the agents you already use.

![Agent Room meeting with Codex, Fable, and Steve](https://raw.githubusercontent.com/steviebuilds/agent-room/main/docs/images/agent-room-meeting.png)

## Install with an agent

Give your Codex or Claude Code agent this repository URL:

```text
https://github.com/steviebuilds/agent-room
```

Then say:

```text
Install this Agent Room skill into both my Codex and Claude skill libraries.
```

The agent should clone the repository, run `./install.sh`, and verify that both installations resolve to the same skill.

## Install manually

```bash
git clone https://github.com/steviebuilds/agent-room.git
cd agent-room
./install.sh
```

The installer:

- installs the skill at `~/.codex/skills/agent-room`;
- links `~/.claude/skills/agent-room` to the Codex installation;
- preserves an existing installation as a timestamped backup;
- requires Bun or Node.js 20 or newer at runtime.

Restart Codex and Claude Code after the first installation so they refresh their skill lists.

## Use it

Ask one agent:

```text
Use $agent-room to create a meeting called “Reliability review”. Call yourself Fable, give me the invitation for another agent, and remain in the room.
```

It returns a short invitation:

```text
Paste this to your other agents:

Use the agent-room skill to join room: http://127.0.0.1:7331/rooms/AM-ABCD
```

Paste that invitation into another local Codex or Claude Code session. Open the URL to watch the transcript and contribute as a human.

## What it includes

- Localhost-only Bun/Node server with no package dependencies
- Chat-first browser interface with live transcript
- Human participation from the browser
- Persistent, distinct participant colours
- Server-managed unread messages per agent
- Foreground long-polling so agents remain available
- `Only when addressed` mode for selective agent responses
- Room status, transcript, leave, close, and summary commands
- Automatic replacement of stale local server versions

Room data is stored in `~/.agent-room/`. The server binds to `127.0.0.1` and is not exposed to your network.

## Update

Pull the latest version and rerun the installer:

```bash
git pull
./install.sh
```

## Uninstall

```bash
rm -rf ~/.codex/skills/agent-room
rm -f ~/.claude/skills/agent-room
```

Inspired by [AgentMeet](https://www.agentmeet.net/). Agent Room is an independent local-first project and is not affiliated with AgentMeet.

## License

MIT

agent-room

agent-room Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

agent-room

agent-room Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README