openchamber README

The project's README from github.com/openchamber/openchamber. As one markdown file: README.md.

OpenChamber

GitHub stars GitHub release Discord Support the project

Run agent work. Keep control. Ship from anywhere.

OpenChamber is an open-source workspace for running and reviewing AI coding work on desktop, web, VS Code, and mobile.

Start agent work, see what changed, and take it through review and release. Your projects and sessions remain available when you switch devices or step away.

OpenChamber Chat

More screenshots

VS Code Extension

OpenChamber PWA chat OpenChamber PWA diff review

What you can do with OpenChamber

Goals that continue on their own

Give a session a finish line with Session Goals. OpenChamber checks the result after every turn and keeps the agent working until it completes the goal, gets blocked, or reaches the limit you set. It can continue after you close the app.

Compare and combine runs

Use Multi-run to give the same task to up to five models, each in its own session and optionally its own worktree. See what each one actually built, choose the best result, or use Fusion to combine the strongest parts into a new session.

Guided changes walkthroughs

Changes Walkthrough turns a large diff into an AI-guided tour of the change. It groups related edits into steps, puts them in the order the change makes sense, and explains how the pieces fit together.

Inspect a running app

Open your app beside the conversation with Preview. Point at an element to send the agent its screenshot, styles, position, and browser errors. No more trying to explain "this thing here." The desktop app can do the same with any web page in its built-in browser.

GitHub context from issue to pull request

Start a session from a GitHub issue or pull request with its context attached. Send failed checks or review comments back to the agent, then update or merge the pull request from OpenChamber.

Continue on another device

Open the same projects and sessions from Desktop, Web/PWA, VS Code, iOS, or Android. Check progress, answer questions, review changes, and reattach to a running terminal.

Private remote access

Pair a device with a one-time QR code and connect through Private Relay without opening ports or exposing a public server. The connection is end-to-end encrypted and can be revoked at any time. Direct connections, LAN/VPN access, Cloudflare/Ngrok tunnels, and SSH are also supported.

Track work across projects

See which sessions are working, waiting, finished, or failed, along with approvals, scheduled tasks, provider limits, token use, and costs. Organize sessions into folders and keep notes, todos, and reusable project actions nearby.

Schedule recurring work

Run a prompt once, daily, weekly, or on a cron schedule. Scheduled tasks can use Session Goals, so they continue toward an outcome instead of stopping after one response.

Use it where you work

Surface Role
Desktop The complete workspace for macOS, Windows, and Linux, with multiple windows, Mini Chat, remote machines, SSH, and native notifications
Web / PWA Open your workspace in a browser, install it as an app, and stay up to date through background notifications
VS Code Keep sessions beside your code, send selections to the agent, open results in the editor, and compare parallel runs
iOS / Android Review and steer work away from your desk, receive completion alerts, and use the terminal with touch controls
CLI / Server Run OpenChamber on a workstation or server, schedule work, manage remote access, and keep it available after login

Quick start

Desktop for macOS, Windows, and Linux

Download the latest release from GitHub Releases. Desktop bundles the matching OpenCode CLI, so no separate OpenCode installation is required.

Linux releases are available as x86_64 and ARM64 AppImages. Make the downloaded AppImage executable and keep it in a writable location for in-app updates:

chmod +x OpenChamber-*.AppImage
./OpenChamber-*.AppImage

Linux AppImages require FUSE (libfuse.so.2). Without FUSE, run with APPIMAGE_EXTRACT_AND_RUN=1.

VS Code

Install OpenChamber from the Visual Studio Marketplace, or search for "OpenChamber" in Extensions.

CLI for Web and PWA

Requires Node.js 22+. CLI/Web and VS Code use your installed OpenCode CLI.

curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash
openchamber --ui-password be-creative-here

Common operations:

openchamber status
openchamber connect-url --qr
openchamber tunnel start --provider cloudflare --mode quick --qr
openchamber startup enable
openchamber logs
openchamber stop
openchamber update

OpenChamber binds to localhost by default. Use --lan only on a trusted network and protect browser access with --ui-password.

Guides

Go deeper with the OpenChamber guides:

For self-hosting details, see the reverse proxy guide. For custom theme authoring, see the custom themes guide.

Why OpenCode?

OpenChamber uses OpenCode to run coding agents. We chose it because it is open source, has a solid API, and is easy to extend.

OpenChamber handles the rest of the workflow. You can decide what to try, keep the agent on track, review the result, connect from another device, and ship the change.

OpenChamber is an independent project and is not affiliated with the OpenCode team.

Contributing

See CONTRIBUTING.md for development setup and contribution guidelines. Documentation authoring guidance lives in packages/docs.

Acknowledgments

Special thanks to:

License

MIT

openchamber (openchamber/openchamber)

Searching Database…

这是干什么的?OpenChamber 是一个开源工作区,用来运行和查看 AI 编程代理的工作成果:你可以给代理下达任务,查看它改动了什么,并从桌面端、网页端、VS Code 或手机端走完审核和发布流程。
它是一个应用还是一整套应用?它是一个工作区,有多种使用界面:支持 macOS、Windows 和 Linux 的桌面应用、浏览器里的网页版/PWA、VS Code 扩展、iOS 和 Android 应用,还有 CLI/服务器模式。切换设备时,项目和会话都依然可用。
怎么把它跑起来?从 GitHub Releases 下载适用于 macOS、Windows 或 Linux 的最新版本——桌面应用自带 OpenCode CLI。如果想在浏览器里用,请运行 CLI(需要 Node.js 22+),并在 Marketplace 安装 VS Code 扩展。
我需要单独安装 OpenCode 代理吗?桌面应用不需要:它自带配套的 OpenCode CLI。CLI/网页版和 VS Code 扩展则需要用你已安装的 OpenCode CLI,它要求 Node.js 22+。
安装或安全方面有什么坑需要知道?Linux 版本是 x86_64 和 ARM64 的 AppImage,需要 FUSE(libfuse.so.2);没有它的话,可以用 APPIMAGE_EXTRACT_AND_RUN=1 来运行。服务器默认只绑定 localhost——--lan 只在可信网络里使用,并用 --ui-password 保护访问。
怎么在手机上访问它,又不用暴露一个公网服务器?用一次性二维码配对设备,然后通过 Private Relay 连接:不用开放端口,端到端加密,随时可以撤销。此外也支持直连、局域网/VPN 访问、Cloudflare/Ngrok 隧道和 SSH。
Multi-run 和 Fusion 是什么?Multi-run 会把同一个任务交给最多五个模型,每个模型在各自的会话里运行,还可以各自使用独立的 git worktree,这样你就能对比它们各自真正做出了什么。Fusion 随后把这些结果中最好的部分合并到一个新会话里。
Session Goals 是什么?你给一个会话设定一个目标终点,OpenChamber 会在每一轮之后检查结果,让代理一直干到目标完成、遇到阻碍,或者达到你设置的上限为止。就算你关掉了应用,它也能继续运行。
Size
405.6 MB
Stars
11.8K
Age
1y
Commits · 90 Days