https://github.com/longyangxi/bit-office
Bit-Office is a real office for your AI agents. Agents communicate, collaborate, and work together like a real team. Assign tasks, coordinate multiple LLM CLIs(Claude, Codex, Gemini, OpenCode, Aider...), and watch projects come to life with live previews.
https://github.com/longyangxi/bit-office
ably ai-agents claude-code cli codex developer-tools gemini multi-agent nextjs orchestration pixel-art pwa telegram-bot typescript websocket
Last synced: 3 months ago
JSON representation
Bit-Office is a real office for your AI agents. Agents communicate, collaborate, and work together like a real team. Assign tasks, coordinate multiple LLM CLIs(Claude, Codex, Gemini, OpenCode, Aider...), and watch projects come to life with live previews.
- Host: GitHub
- URL: https://github.com/longyangxi/bit-office
- Owner: longyangxi
- Created: 2026-03-01T04:31:49.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-03-08T06:15:27.000Z (3 months ago)
- Last Synced: 2026-03-08T11:21:09.953Z (3 months ago)
- Topics: ably, ai-agents, claude-code, cli, codex, developer-tools, gemini, multi-agent, nextjs, orchestration, pixel-art, pwa, telegram-bot, typescript, websocket
- Language: TypeScript
- Homepage:
- Size: 55.1 MB
- Stars: 55
- Watchers: 0
- Forks: 16
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bit Office
### Pixel office for AI agents and multi-agent collaboration
[](https://www.npmjs.com/package/bit-office)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
[](https://github.com/longyangxi/bit-office/pulls)
**Support Claude, Codex, Gemini, Aider etc. — one team, getting better every project.**
[Quick Start](#quick-start) | [Features](#features) | [Team Workflow](#team-workflow) | [Architecture](#architecture) | [Contributing](#contributing)
---
## What is Bit Office
Bit Office gives AI automation a **visible, controllable workspace**. Different AI models collaborate as one team under a Team Leader — planning, coding, reviewing, and delivering in a single flow, all rendered in a live pixel-art office you can watch, control, and share.
What makes it different: **agents get better over time**. Rate each project on creativity, visual quality, interaction, completeness, and engagement. Your ratings and review patterns are stored as persistent memory — the next time the team plans a project, they know what scored low and actively improve on it.
## Quick Start
```bash
npx bit-office
```
That's it. This will:
1. Start a local gateway daemon
2. Open the pixel-art office UI in your browser
3. Auto-detect installed AI CLIs (Claude, Codex, Gemini, Aider, OpenCode)
4. Generate a pair code for mobile access
## Features
### Multi-Agent Teams
A **Team Leader** coordinates specialists like Developer and Code
Reviewer to plan, implement, and validate tasks automatically.
### Multi-Model Workflows
Run **Claude, Codex, Gemini, Aider, and OpenCode** together in one
pipeline, letting each model focus on what it does best.
### Pixel Office Workspace
Watch agents work in real time inside a **PixiJS pixel-art office**,
with live status, logs, and progress visualization.
### Instant Preview & Rating
Every completed task generates an **auto preview**. Rate the result
across five dimensions — your feedback becomes **persistent memory**
that shapes how agents approach the next project.
### Self-Improving Agents
Review patterns, tech preferences, and project ratings are stored
across sessions. Agents **learn what you value** and adapt — low
visual scores lead to richer designs, recurring review failures get
avoided automatically.
### Token Cost Visibility
Track **token usage per agent and per team** in real time so you always
know the cost of each run.
### Live Sharing & Mobile Control
Invite others to watch progress, leave feedback, or manage sessions
directly from your phone.
### Cross-Device Sync
Real-time collaboration powered by **WebSocket, Ably, and Telegram
channels**.
### Project History
Every run is saved with a **replayable preview**, letting you revisit
results and build on previous work.
## Team Workflow
| Phase | What Happens | Your Action |
|---|---|---|
| **Create** | Team Lead gathers intent and scope | Describe what to build |
| **Design** | Team Lead proposes implementation plan | Approve or request changes |
| **Execute** | Developer implements, Reviewer validates | Monitor or cancel |
| **Complete** | Preview and summary delivered | Rate, give feedback, or end project |
Ratings persist as agent memory. The next project starts with lessons from the last one.
Full details in [team-workflow.md](team-workflow.md).
## Use Cases
- **AI-native prototyping** — go from idea to working preview in one session
- **Feature spikes** — rapid implementation with continuous preview feedback
- **Multi-model experiments** — compare how different AI backends approach the same task
- **Live demos** — show autonomous development workflows to your team or audience
## Run from Source
### Prerequisites
- **Node.js** 18+
- **pnpm**
- At least one AI CLI installed: `claude`, `codex`, `gemini`, `aider`, or `opencode`
### Setup
```bash
git clone https://github.com/longyangxi/bit-office.git
cd bit-office
pnpm install
pnpm dev
```
### Scripts
| Command | Description |
|---|---|
| `pnpm dev` | Web + gateway in dev mode |
| `pnpm dev:web` | Web only (Next.js) |
| `pnpm dev:gateway` | Gateway only |
| `pnpm build` | Build all packages |
| `pnpm start` | Build web and start gateway |
### Environment Variables
| Variable | Required | Description |
|---|---|---|
| `WORKSPACE` | No | Agent working directory |
| `ABLY_API_KEY` | No | Remote real-time channel |
| `TELEGRAM_BOT_TOKENS` | No | One token per bot/agent (comma-separated) |
| `WEB_DIR` | No | Override served web build directory |
## Architecture
```
bit-office/
├── apps/
│ ├── web/ # Next.js PWA + PixiJS pixel office + control UI
│ └── gateway/ # Runtime daemon: events, channels, policy, orchestration
└── packages/
├── orchestrator/ # Multi-agent execution engine
└── shared/ # Typed command/event contracts (Zod schemas)
```
**Channels**: WebSocket (always on), Ably (optional), Telegram (optional)
## Tech Stack
- **Frontend**: Next.js 15, React, PixiJS v8, Zustand
- **Backend**: Node.js daemon, WebSocket
- **Protocol**: Zod-validated event schemas
- **Integrations**: Ably, Telegram, external process detection
## Contributing
Issues and PRs are welcome. If you're exploring AI-native dev tooling, workflows, or interfaces, Bit Office is a great playground for experiments.
## Acknowledgments
Pixel office art inspired by [pixel-agents](https://github.com/pablodelucca/pixel-agents) by [@pablodelucca](https://github.com/pablodelucca).
## License
[MIT](LICENSE) - feel free to use, modify, and distribute.
---
**If Bit Office helps your workflow, consider giving it a star!**