agentbox

Open your browser. Pick up your AI coding work.

Run Claude Code and Codex CLI on your own server.
Chat, terminal, files, and code review share one persistent workspace.

English | 简体中文

Screenshots · Quick start · Documentation · Deployment and operations · Report an issue

_{From a task to code you can review. Chat, terminal, files, and Git in one workspace.}

The server is a single Go binary with an embedded frontend, using SQLite for state and Docker to isolate workspaces, with systemd deployment and backup tools included.

These are browser screenshots of the current source UI, using synthetic projects, conversations, terminal output, and usage data. They contain no real accounts or business records and do not represent live model results. Released versions may differ from the current source. Click an image to enlarge it. The app interface is currently in Chinese.

From task to code	From code to delivery
Terminal · Keep your working session Run commands, use the original CLI, and reattach to tmux after a disconnect.	Changes · Review every edit Browse diffs and complete files, then commit after review.
Files · Manage source and artifacts Edit, preview, and download archives from project and shared directories. The source viewer includes line numbers, syntax highlighting, current-line highlighting, line/column navigation, and fullscreen mode.	Usage · Understand your costs Filter by user, model, and time; inspect pricing sources and turn latency.
Accounts · Manage access centrally Maintain Claude / Codex accounts and control which users may use them.	Private network · Reach services accessible from your computer Access allowed targets transparently and inspect client and workspace network status.

Light theme and mobile UI

Choose system, light, or dark themes. Narrow screens use drawer navigation, and touch terminals include a shortcut key bar one-finger swipes to scroll back through output, and long-press to paste.

See the development guide for instructions to reproduce these screenshots.

abox-link is optional. You do not need to install it for regular browser use.

flowchart LR
    B[Browser] -->|HTTPS / WebSocket| S[agentbox server]
    S -->|Docker API| W["Workspace container<br/>Claude Code / Codex CLI"]
    S --> D[(SQLite and chat history)]
    F["Persistent directories<br/>workspace / home / shared"] --- W
    W --> P[Model service / account egress proxy]
    W -. Private network on demand .-> S
    S -. WSS tunnel .-> L[Local abox-link]
    L --> N[Allowlisted services]

Each workspace has a container and a set of persistent directories. A workspace can have multiple chat threads, but only one Web chat turn runs at a time. Each user's shared directory is mounted at /shared in all of their workspaces.

The console supports page deep links, light and dark themes, and mobile access. On mobile, System settings and Git management use a submenu switcher at the top right; toolbars use icons, less frequent actions live under More, and long-pressing an icon shows its description. File previews keep a close control visible, and diff details provide a way back to the file list. Desktop layouts retain text actions and split navigation. Chat supports model and reasoning-effort selection; each response shows its time, model, settings snapshot, and recorded cost. See the workspace guide for full instructions.

Run on a Linux server:

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

The current stable release is v0.1.8. The installer selects the latest stable release by default. Append -s -- --version v0.1.8 to pin this version.

On SELinux systems such as Oracle Linux / RHEL, if an older package fails to start with 203/EXEC / Permission denied, follow SELinux installation recovery to repair executable labels before retrying activation.

The installer supports Linux x86_64 / arm64 with systemd. On Ubuntu 22.04+ and Debian 12+, it installs missing dependencies and Docker automatically. Other distributions require Python 3.9+, Git, curl, CA certificates, timezone data, and a local Docker Engine to be installed first. The server uses prebuilt packages, so Go and Node are not required on the server.

The command verifies the release package, builds a workspace image with pinned versions, generates configuration and a random administrator password, and installs and starts agentbox.service. The first image build takes a few minutes and requires access to container registries, Debian package repositories, and npm. Once complete, open http://YOUR_SERVER_IP:8180, sign in as boxadmin with the initial password printed in the terminal, and add an account under System settings → Account pool (系统设置 → 账号池). For remote access, allow TCP 8180 through your firewall / security group. Configure HTTPS for ongoing public access.

Append -s -- --listen 127.0.0.1:8180 to restrict access to the local machine or a reverse proxy. Configuration and data are stored in /etc/agentbox and /var/lib/agentbox. If an existing deployment is detected, the installer stops and preserves its files. See the installation guide for upgrades, recovery, and all options.

git clone https://github.com/devilcoolyue/agentbox.git
cd agentbox

go build -o agentbox ./cmd/agentbox
./scripts/build-image.sh

cp config.example.json config.json
openssl rand -hex 24

{
  "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

ssh -N -L 8180:127.0.0.1:8180 user@your-server

sudo ./deploy/install.sh
sudo ./deploy/deploy.sh

Administrators maintain the account pool. Each account has one of three access scopes: all users, selected users, or administrators only, configured through its Access scope control. Older configurations without this setting remain shared with all users. Administrators can always use all accounts, but their workspace API requests are still checked against workspace ownership; system administration does not grant an interface for browsing other users' workspaces. Server administrators can still access persistent data on the host directly.

Revoking account access blocks new operations and further credential synchronization. It does not withdraw credentials already delivered or terminate running processes; complete revocation also requires stopping the relevant containers and rotating upstream credentials. Account credentials are provided to the CLI inside containers, and users with terminal access can read them. Shared account pools are therefore intended for trusted users; do not share administrator subscriptions or API credentials with untrusted users.

A few operational boundaries:

• Persistent files do not imply persistent processes. You can reconnect after a terminal network disconnect, but stopping or rebuilding a container terminates its processes. Store files you need to keep in /workspace, /home/agent, or /shared.
• Credit limits are not real-time hard caps. Web turns settle when they finish, so the turn that exhausts a balance may overspend. Claude / Codex terminal usage backfill does not deduct credits.
• Default system backups exclude workspace data. They cover the database, configuration, account credentials, both template layers, and MCP management state. agentbox backup --full also includes user files and history and requires stopping the service and relevant containers first. Use backup-verify to verify backups and restore --to to restore into a new directory. See backup and restore.
• Production deployment briefly disconnects clients. The current architecture uses one machine, one server process, and a local Docker daemon. Only one agentbox process may use a given data_dir.
• Agents can execute code in containers. The default permission mode is bypassPermissions. Containers run as a non-root user with resource limits and no-new-privileges. The server has Docker access and is intended to be deployed and maintained by trusted administrators.
• Git review runs inside workspace containers. Opening review starts the workspace if necessary and applies the same credit admission checks as terminal access. Web commits do not run Git hooks or signing; use the terminal if you need them.
• Remote browser: the workspace Browser tab provides a full desktop browser for Claude, ChatGPT, and other websites, with a compact address toolbar, persistent login state per workspace, tabs, fullscreen, adjustable picture quality, a UTF-8 clipboard, and workspace downloads. Administrators must build and select the optional agentbox-agent:browser image: Google Chrome on Linux amd64, Chromium on ARM. Account proxies, workspace access, and resource limits apply. Website login is separate from CLI authorization. See setup and usage.
• Commit locally in the Web UI does not push to a remote. Set the shared name / email for your Web commits through Git management → Commit identity in the user menu, or Git identity on the Changes page; defaults are your username and username@localhost. Remote ahead / behind counts come from the local cache; refreshing does not fetch. Git management is a separate page available to regular users, at the same level as System settings, with a guide, commit identity, and repository connections. It supports page refresh and browser back / forward navigation; connections and authorizations are managed within the page. Repository connections support HTTPS tokens and SSH private keys. Clone repositories from Changes; use Remote to bind a connection, fetch, pull by fast-forward, or preview and push. Administrators can register GitHub / GitLab OAuth apps so users can authorize reusable connections in the browser. Operations report progress and can be canceled. Enterprise Git supports company CAs and user private-network tunnels; SSH pins server host keys. Web branch management supports creation, switching, upstream configuration, and deletion of merged branches. GitHub / GitLab PR / MR creation includes a preview. Administrators can share dedicated service accounts with per-user read / write limits. A 30-minute terminal authorization is also available; long-term credentials remain on the server. Connections belong to users, workspaces select a default, and repositories bind connections per remote. See the Git management notes for implementation boundaries and the maintenance guide for offline key rotation.
• Web file operations do not follow symbolic links. Workspaces, shared directories, skills, and credential files use restricted directory handles. Uploads are validated in temporary directories, and editor saves use atomic replacement. Container CLIs can still use links from templates.

The workspace MCP tab provides add/edit dialogs with draft retention on save errors, manages user defaults and workspace overrides, imports mcpServers JSON, and tests stdio/HTTP connections inside the container. The list separates configuration status from a compact action bar: connection checks keep their label, edit/copy/delete use icons with tooltips, and a switch controls enablement. Changes apply on the next chat turn, terminal connection, or workspace start; restart an already running terminal Claude to reload them. Existing native entries require explicit adoption. Header/env secrets are masked in API responses; on-disk configuration is private (0600), not encrypted. OAuth remains a terminal operation and the independent checker does not reuse CLI OAuth credentials. User and workspace MCP control files are included in system backups; runtime home/OAuth files require full backups. See Skills, plugins, and MCP for precedence, conflict handling, API details, and limits.

New installations can use versioned release directories, with configuration, data, and marketplace cache stored in /etc/agentbox, /var/lib/agentbox, and /var/cache/agentbox. Deployments inside the source repository remain supported. The deployment layout and migration guide covers installation, upgrades, rollback, offline migration, and backups.

Pricing in System settings offers a models.dev source preset and custom HTTPS catalogs. Daily server checks import Anthropic / OpenAI prices, adapting Claude one-hour cache writes and explicit context tiers; incomplete or unsupported prices remain pending review. Updates require confirmation by default, with optional automatic updates for selected models (changes above 25%, zero-price transitions, and tier-rule changes require manual review). Custom prices stay protected. Price updates need no redeployment; historical price snapshots and rollback are retained, and rollback pauses automatic application. Sources require explicit configuration; the bundled older snapshot does not claim to be current. See pricing catalog maintenance.

Containers and resources in System settings provides global / per-user running container limits, reserved disk space, background disk usage statistics, marketplace cache cleanup, and sanitized diagnostic downloads. The usage page reads recorded entries and shows the terminal scan time; backfill runs in the background.

Claude web chat deduplicates usage by message ID, completes usage from new transcript records, and prices each request using the table pinned at turn start. Resumed session totals are never charged again. Message identities and credit deductions commit together (database schema 9). Existing history is not automatically repriced. Usage details and CSV include cache hit rate: cache reads / (uncached input + cache reads + cache writes); no input displays “—”.

The English and Chinese READMEs cover the same features and setup steps. Detailed guides are currently available in Chinese. Start with the documentation index for guidance by role.

go build ./...
go test ./...

# When editing the frontend; CI uses Node.js 22
npm ci
npm run check
npm run build

When editing web/src/*.ts, also commit the generated files in internal/web/static/js/. See the development guide for Linux container checks, optional live model tests, and abox-link builds.

See CONTRIBUTING.md for contribution steps, SECURITY.md for private vulnerability reporting, CHANGELOG.md for changes, and third_party/ for third-party licenses. Binary candidates and installation workflows are described in the release guide; pinned CLI versions are listed in the compatibility matrix.

Focused issues and pull requests are welcome. Include your platform, source revision, reproduction steps, and sanitized logs. Keep real credentials, user files, and databases out of commits and screenshots.

Agentbox is licensed under Apache-2.0; see NOTICE for copyright notices. Third-party components retain their own licenses. Model services and runtime CLIs remain subject to their upstream usage and redistribution terms; see the third-party notes.

Thanks to the LINUX DO community for its support and discussions.

• LINUX DO - A new kind of ideal community