{"id":47224826,"url":"https://github.com/longyangxi/bit-office","last_synced_at":"2026-03-13T19:27:50.889Z","repository":{"id":341316788,"uuid":"1169703426","full_name":"longyangxi/bit-office","owner":"longyangxi","description":"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.","archived":false,"fork":false,"pushed_at":"2026-03-08T06:15:27.000Z","size":57760,"stargazers_count":55,"open_issues_count":1,"forks_count":16,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-08T11:21:09.953Z","etag":null,"topics":["ably","ai-agents","claude-code","cli","codex","developer-tools","gemini","multi-agent","nextjs","orchestration","pixel-art","pwa","telegram-bot","typescript","websocket"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/longyangxi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T04:31:49.000Z","updated_at":"2026-03-08T10:10:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/longyangxi/bit-office","commit_stats":null,"previous_names":["longyangxi/bit-office"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/longyangxi/bit-office","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longyangxi%2Fbit-office","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longyangxi%2Fbit-office/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longyangxi%2Fbit-office/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longyangxi%2Fbit-office/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/longyangxi","download_url":"https://codeload.github.com/longyangxi/bit-office/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longyangxi%2Fbit-office/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30473202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T17:15:31.527Z","status":"ssl_error","status_checked_at":"2026-03-13T17:15:22.394Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ably","ai-agents","claude-code","cli","codex","developer-tools","gemini","multi-agent","nextjs","orchestration","pixel-art","pwa","telegram-bot","typescript","websocket"],"created_at":"2026-03-13T19:27:49.449Z","updated_at":"2026-03-13T19:27:50.747Z","avatar_url":"https://github.com/longyangxi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Bit Office\n\n### Pixel office for AI agents and multi-agent collaboration\n\n[![npm version](https://img.shields.io/npm/v/bit-office?color=cb3837\u0026logo=npm)](https://www.npmjs.com/package/bit-office)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/longyangxi/bit-office/pulls)\n\n**Support Claude, Codex, Gemini, Aider etc. — one team, getting better every project.**\n\n[Quick Start](#quick-start) | [Features](#features) | [Team Workflow](#team-workflow) | [Architecture](#architecture) | [Contributing](#contributing)\n\n\u003c/div\u003e\n\n---\n![Image](https://github.com/user-attachments/assets/8764fec6-f033-4d84-8953-d9ab6f0a25f2)\n\n## What is Bit Office\n\nBit 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.\n\nWhat 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.\n\n## Quick Start\n\n```bash\nnpx bit-office\n```\n\nThat's it. This will:\n\n1. Start a local gateway daemon\n2. Open the pixel-art office UI in your browser\n3. Auto-detect installed AI CLIs (Claude, Codex, Gemini, Aider, OpenCode)\n4. Generate a pair code for mobile access\n\n## Features\n\n### Multi-Agent Teams\n\nA **Team Leader** coordinates specialists like Developer and Code\nReviewer to plan, implement, and validate tasks automatically.\n\n### Multi-Model Workflows\n\nRun **Claude, Codex, Gemini, Aider, and OpenCode** together in one\npipeline, letting each model focus on what it does best.\n\n### Pixel Office Workspace\n\nWatch agents work in real time inside a **PixiJS pixel-art office**,\nwith live status, logs, and progress visualization.\n\n### Instant Preview \u0026 Rating\n\nEvery completed task generates an **auto preview**. Rate the result\nacross five dimensions — your feedback becomes **persistent memory**\nthat shapes how agents approach the next project.\n\n### Self-Improving Agents\n\nReview patterns, tech preferences, and project ratings are stored\nacross sessions. Agents **learn what you value** and adapt — low\nvisual scores lead to richer designs, recurring review failures get\navoided automatically.\n\n### Token Cost Visibility\n\nTrack **token usage per agent and per team** in real time so you always\nknow the cost of each run.\n\n### Live Sharing \u0026 Mobile Control\n\nInvite others to watch progress, leave feedback, or manage sessions\ndirectly from your phone.\n\n### Cross-Device Sync\n\nReal-time collaboration powered by **WebSocket, Ably, and Telegram\nchannels**.\n\n### Project History\n\nEvery run is saved with a **replayable preview**, letting you revisit\nresults and build on previous work.\n\n## Team Workflow\n\n| Phase | What Happens | Your Action |\n|---|---|---|\n| **Create** | Team Lead gathers intent and scope | Describe what to build |\n| **Design** | Team Lead proposes implementation plan | Approve or request changes |\n| **Execute** | Developer implements, Reviewer validates | Monitor or cancel |\n| **Complete** | Preview and summary delivered | Rate, give feedback, or end project |\n\nRatings persist as agent memory. The next project starts with lessons from the last one.\n\nFull details in [team-workflow.md](team-workflow.md).\n\n## Use Cases\n\n- **AI-native prototyping** — go from idea to working preview in one session\n- **Feature spikes** — rapid implementation with continuous preview feedback\n- **Multi-model experiments** — compare how different AI backends approach the same task\n- **Live demos** — show autonomous development workflows to your team or audience\n\n## Run from Source\n\n### Prerequisites\n\n- **Node.js** 18+\n- **pnpm**\n- At least one AI CLI installed: `claude`, `codex`, `gemini`, `aider`, or `opencode`\n\n### Setup\n\n```bash\ngit clone https://github.com/longyangxi/bit-office.git\ncd bit-office\npnpm install\npnpm dev\n```\n\n### Scripts\n\n| Command | Description |\n|---|---|\n| `pnpm dev` | Web + gateway in dev mode |\n| `pnpm dev:web` | Web only (Next.js) |\n| `pnpm dev:gateway` | Gateway only |\n| `pnpm build` | Build all packages |\n| `pnpm start` | Build web and start gateway |\n\n### Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `WORKSPACE` | No | Agent working directory |\n| `ABLY_API_KEY` | No | Remote real-time channel |\n| `TELEGRAM_BOT_TOKENS` | No | One token per bot/agent (comma-separated) |\n| `WEB_DIR` | No | Override served web build directory |\n\n## Architecture\n\n```\nbit-office/\n├── apps/\n│   ├── web/            # Next.js PWA + PixiJS pixel office + control UI\n│   └── gateway/        # Runtime daemon: events, channels, policy, orchestration\n└── packages/\n    ├── orchestrator/   # Multi-agent execution engine\n    └── shared/         # Typed command/event contracts (Zod schemas)\n```\n\n**Channels**: WebSocket (always on), Ably (optional), Telegram (optional)\n\n## Tech Stack\n\n- **Frontend**: Next.js 15, React, PixiJS v8, Zustand\n- **Backend**: Node.js daemon, WebSocket\n- **Protocol**: Zod-validated event schemas\n- **Integrations**: Ably, Telegram, external process detection\n\n## Contributing\n\nIssues and PRs are welcome. If you're exploring AI-native dev tooling, workflows, or interfaces, Bit Office is a great playground for experiments.\n\n## Acknowledgments\n\nPixel office art inspired by [pixel-agents](https://github.com/pablodelucca/pixel-agents) by [@pablodelucca](https://github.com/pablodelucca).\n\n## License\n\n[MIT](LICENSE) - feel free to use, modify, and distribute.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If Bit Office helps your workflow, consider giving it a star!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongyangxi%2Fbit-office","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flongyangxi%2Fbit-office","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongyangxi%2Fbit-office/lists"}