Real isolation, not worktrees
Every instance is its own Docker container — no shared worktrees, no port collisions, no accidentally killing your dev server, and nothing left behind to clean up when you're done.
Isolated workspaces for your Claude / Codex (coming soon) agents.
Point Codebay at a local folder or a Git repo URL and it spins up a fully isolated devcontainer with its own browser-based VS Code — built for running parallel agent workflows without them stepping on each other.
$ bunx codebay@latest
Read the docs
What makes Codebay different?
Not another wrapper around an agent SDK — the real thing, properly sandboxed.
Local or fully remote
Run it against Docker Desktop or Colima on your laptop, or run it on a remote server and drive every instance from the browser.
Real Claude Code, always current
No abstractions in the way — it's the actual Claude Code CLI running in each container, so you get the latest features the day they ship.
Your auth, zero config
Existing Claude Code and GitHub credentials are copied into every container automatically — no re-logging in, no tokens to paste.
Unsupervised agents… if you want / dare / care
Agents have become great at working autonomously, but sometimes you want to jump in and help them out. Codebay provides this through a full VS Code experience in addition to Claude Code.
Codebay
Fully manual
Fully autonomous
The control pane for your agents
Every agent visible from one dashboard, with live status and notifications built in.
Everything wired up for you
Handled automatically, out of the box.
Local folder or Git URL
Copy a folder or clone a repo — .git history comes along either way.
Browser-based VS Code
Every instance runs its own code-server, proxied behind your password.
Ready-to-run dev environment
tmux, git identity, and Claude Code aliases, injected automatically.
Notifications
Agents ping you when done or waiting — a pulsing tab plus an optional chime.
Live dashboard
Instance list and health, streamed live over WebSockets.
Port forwarding
Declared ports are published automatically — add more anytime.
Runs itself, too
Ship Codebay itself as a container — Docker-outside-of-Docker.
One command start
bunx codebay@latest and you're live at localhost:6969.
Light & dark mode
Pick a theme — the dashboard and every code-server tab follow along.
How it works
From source to a running browser IDE in four steps.
1
Pick a source
A local folder, or paste a Git repo URL.
2
Codebay injects the tooling
code-server, port forwards, and your credentials go into
devcontainer.json.
3
devcontainer up
The official CLI builds and starts your container.
4
Open the browser IDE
A unique host port, proxied and password protected.
Every instance gets a mascot
A cute sprite to keep you company. Use one of the existing ones or draw your own.
Get started
One command and you're live.
$ bunx codebay@latest
Requirements
- Bun ≥ 1.3.14
- A running Docker daemon (Docker Desktop, Colima, OrbStack…)
- macOS or Linux