agentbox

Your AI coding workspace. On your server. In your browser.

Run Claude Code and Codex CLI on a Linux server you control. Go from a task to reviewed code with chat, terminal, files, and Git in one place.

English | 简体中文

Quick start · Watch the tour · Screenshots · Architecture · Documentation

Why agentbox?

Set up your coding environment once on your server, then pick up your project from a laptop, desktop, or phone. Your local machine only needs a browser; the agents and project tools run in Docker on the server.

You bring the server and your own Claude / Codex subscription, API key, or compatible relay account. Agentbox provides the workspace and management layer; model usage follows your provider's terms and pricing.

See the workflow

Chat → terminal → Git review → previews. The GIF introduces the core workspace; the 34-second MP4 also visits skills, MCP, usage, and private-network access.

Screenshots use 2× pixel density. All media is captured from the actual browser UI with synthetic projects, conversations, command output, and usage records. These are interface demonstrations, not live model benchmarks. The media was captured before multilingual support was added and shows the Chinese interface; v0.1.10 also supports Traditional Chinese and English.

Interface languages

The Web console and abox-link v0.1.10 support 简体中文 · 繁體中文 · English. Choose a language on the login page, in the Web console’s user menu, or at the top of the abox-link panel. The default follows your browser/system language, falling back to English when unsupported; explicit choices are saved on the current device.

Switch immediately while keeping drafts and terminal connections. User content, model responses, terminal output, and server diagnostics remain in their original language. Language behavior and desktop availability →

Quick start

Install on your Linux server

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox/main/install.sh | sudo bash

The installer downloads and verifies the server package, builds the workspace image, and starts agentbox.service. No Go or Node.js installation is needed on the server. The first image build takes a few minutes and needs access to container registries, Debian repositories, and npm.

• Host: Linux x86_64 / arm64, systemd, and local Docker Engine. Ubuntu 22.04+ / Debian 12+ install missing dependencies automatically. For other distributions, see the prerequisites.
• Sign in: open http://YOUR_SERVER_IP:8180 and use boxadmin with the generated password printed by the installer. Allow TCP 8180 through your firewall if connecting directly; configure HTTPS for ongoing public access.
• Stable server: v0.1.11. The command selects the latest stable release; append -s -- --version v0.1.11 to pin it, or -s -- --listen 127.0.0.1:8180 to bind only to localhost.
• Existing installation: use the console's update entry or the upgrade guide. The installer preserves existing deployments and will not overwrite them.

Configuration lives in /etc/agentbox, data in /var/lib/agentbox. Each workspace defaults to a 2 GiB memory limit and 2 CPUs; size your server for the number of concurrent workspaces. See installation and recovery for all options.

Your first task

The workspace uses a one-time, three-step tour with Skip and replay under More → Quick tour. It does not reserve workspace space. Workspace filters share one row, and draft settings live in the composer toolbar.

v0.1.11 adds a role-based first-use guide: administrators check the environment, connect accounts and review defaults; users see their authorized accounts. Workspace creation refreshes access and disables submission when no account is available. See M2 progress; this release supports empty, upload and Git project creation with persistent receipts. See project import and recovery; creation receipts were introduced in schema 11, and this release also includes schema 12 chat receipts.

The UI also confirms workspace configuration and offers an editable first-task example. About and updates distinguishes server, Agent image and desktop updates, including version observations and restart scope; see update components. Desktop UI changes require a separate desktop release.

v0.1.11 adds isolated recovery of unsent chat drafts and attachment checks. It also introduces server schema 12 and a versioned chat receipt API connected to the existing runner, with ID deduplication, status queries and recovery after restart. The browser now saves a frozen outgoing copy before sending, queries the original ID after a lost acknowledgement, and provides explicit result review. Unsent drafts stay separate. Local saving can be disabled; older servers retain the legacy send path with a capability notice. Back up before upgrading; older schema 10/11 binaries cannot open schema 12. See draft recovery and M3 progress.

1. Add an account in System settings → Account pool (系统设置 → 账号池). Choose Claude or Codex and connect a subscription or API / relay account. Account setup →
2. Create a workspace and select its agent and account. You can later switch it to another account of the same agent from the workspace ⋯ menu.
3. Bring your project: upload files, or open Terminal and clone a repository into /workspace.
4. Describe the task in Chat, then inspect files or run commands in Terminal. Both work on the same project files.
5. Review Changes before committing. Download the result, or configure a Git connection to push and open a PR / MR. Workspace guide →

On Linux with Docker, Git, and the Go toolchain in go.mod:

git clone https://github.com/devilcoolyue/agentbox.git
cd agentbox
go build -o agentbox ./cmd/agentbox
./scripts/build-image.sh
openssl rand -hex 24

Save the following as config.json, replacing the password placeholder with the generated random value:

{
  "listen": "127.0.0.1:8180",
  "auth_token": "CHANGE_ME_TO_A_LONG_RANDOM_TOKEN",
  "data_dir": "data",
  "agent_image": "agentbox-agent:latest",
  "accounts": [],
  "proxies": []
}

sudo ./agentbox -config config.json

Open http://127.0.0.1:8180 on the server, or run ssh -N -L 8180:127.0.0.1:8180 user@your-server on your computer and open that address locally. Sign in as boxadmin with the configured auth_token. After first startup the password is stored in the database; editing auth_token does not reset it.

Forgot the administrator password? Starting with v0.1.11, use agentbox admin-reset-password --config /path/to/config.json --user boxadmin: stop the service and verify a backup first, then enter the new password twice in a terminal. It revokes that administrator’s login tokens and preserves workspace and billing data. See the recovery procedure; v0.1.10 and earlier release binaries do not include the command.

The server needs Docker access and permission to set mounted directory ownership to 1000:1000. After stopping this foreground instance, run sudo ./deploy/install.sh and sudo ./deploy/deploy.sh for a source-based systemd installation. See deployment,