Support Claude, Codex, Gemini, Aider etc. — one team, getting better every project.
Quick Start | Features | Team Workflow | Architecture | Contributing
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.
npx bit-officeThat's it. This will:
- Start a local gateway daemon
- Open the pixel-art office UI in your browser
- Auto-detect installed AI CLIs (Claude, Codex, Gemini, Aider, OpenCode)
- Generate a pair code for mobile access
A Team Leader coordinates specialists like Developer and Code Reviewer to plan, implement, and validate tasks automatically.
Run Claude, Codex, Gemini, Aider, and OpenCode together in one pipeline, letting each model focus on what it does best.
Watch agents work in real time inside a PixiJS pixel-art office, with live status, logs, and progress visualization.
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.
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.
Track token usage per agent and per team in real time so you always know the cost of each run.
Invite others to watch progress, leave feedback, or manage sessions directly from your phone.
Real-time collaboration powered by WebSocket, Ably, and Telegram channels.
Every run is saved with a replayable preview, letting you revisit results and build on previous work.
| 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.
- 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
- Node.js 18+
- pnpm
- At least one AI CLI installed:
claude,codex,gemini,aider, oropencode
git clone https://github.com/longyangxi/bit-office.git
cd bit-office
pnpm install
pnpm dev| Command | Description |
|---|---|
pnpm dev |
Web + gateway in dev mode |
pnpm dev:web |
Web only (Next.js) |
pnpm dev:gateway |
Gateway only |
pnpm dev:desktop |
Tauri desktop app (dev mode) |
pnpm build |
Build all packages |
pnpm build:desktop |
Build Tauri .app + .dmg |
pnpm start |
Build web and start gateway |
| 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) |
WS_PORT |
No | Gateway WebSocket port (default: 9090) |
WEB_DIR |
No | Override served web build directory |
Bit Office also ships as a native macOS desktop app powered by Tauri. The app bundles the gateway as a sidecar — no terminal, no browser, just launch and go.
- Node.js 18+, pnpm
- Rust toolchain — install via:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pnpm dev:desktopThis starts the gateway (port 9099), web dev server, and Tauri window in one command.
pnpm build:desktopProduces Bit Office.app and .dmg at:
apps/desktop/src-tauri/target/release/bundle/macos/Bit Office.app
apps/desktop/src-tauri/target/release/bundle/dmg/Bit Office_0.1.0_aarch64.dmg
The release app:
- Auto-starts an embedded gateway (sidecar)
- Connects via local WebSocket (port 9090)
- Minimizes to system tray on close
- Reopens from Dock click
| Mode | Gateway Port | Web |
|---|---|---|
npx bit-office |
9090 | Bundled at same port |
pnpm dev |
9099 | localhost:3000 |
pnpm dev:desktop |
9099 | Tauri window → localhost:3000 |
| Desktop app (release) | 9090 | Tauri window → static export |
bit-office/
├── apps/
│ ├── web/ # Next.js PWA + PixiJS pixel office + control UI
│ ├── gateway/ # Runtime daemon: events, channels, policy, orchestration
│ └── desktop/ # Tauri v2 native shell (macOS .app/.dmg)
└── packages/
├── orchestrator/ # Multi-agent execution engine
└── shared/ # Typed command/event contracts (Zod schemas)
Channels: WebSocket (always on), Ably (optional), Telegram (optional)
- Frontend: Next.js 15, React, PixiJS v8, Zustand
- Desktop: Tauri v2 (Rust + system WebView)
- Backend: Node.js daemon, WebSocket
- Protocol: Zod-validated event schemas
- Integrations: Ably, Telegram, external process detection
Issues and PRs are welcome. If you're exploring AI-native dev tooling, workflows, or interfaces, Bit Office is a great playground for experiments.
Pixel office art inspired by pixel-agents by @pablodelucca.
MIT - feel free to use, modify, and distribute.
If Bit Office helps your workflow, consider giving it a star!
