by devilcoolyue
Self-hosted browser workspace for Claude Code and Codex CLI, with Docker sessions, terminal, files, Git, and usage tracking.
# Add to your Claude Code skills
git clone https://github.com/devilcoolyue/agentboxGuides for using cli tools skills like agentbox.
See how agentbox compares with popular alternatives.
agentbox is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by devilcoolyue. Self-hosted browser workspace for Claude Code and Codex CLI, with Docker sessions, terminal, files, Git, and usage tracking. It has 53 GitHub stars.
agentbox's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/devilcoolyue/agentbox" and add it to your Claude Code skills directory (see the Installation section above).
agentbox is primarily written in Go. It is open-source under devilcoolyue on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agentbox against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
See comparison
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
| What you want to do | How agentbox helps |
|---|---|
| Resume coding anywhere | Connect to persistent workspaces from your browser; code, home configuration, and chat history stay on your server |
| Use familiar agents | Switch between streaming Web chat and the original Claude Code or Codex CLI terminal |
| Take a task through delivery | Upload a project → assign a task → preview files → review Git diffs → commit or download |
| Reuse environments and resources | Per-user /shared directories, two layers of home templates, Claude skill management, and per-user MCP management with workspace overrides |
| Manage accounts and costs centrally | OAuth / API key / relay account pools, per-user access, usage details, pricing catalog updates, historical price snapshots, and a credit ledger |
| Reach your private network | Optional abox-link gives cloud agents access to allowlisted repositories, databases, and services; check the connection status and details from the chat bar |
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.
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.
| Entry point | Best for | What to install |
|---|---|---|
| Browser chat | Assign coding tasks, view streaming results, and manage multiple conversations | Users only need a browser; an administrator deploys the server first |
| Browser terminal | Use the original CLI, run commands, and install project dependencies | CLIs and common tools are included in the workspace image |
| abox-link local panel | Let cloud workspaces access private services reachable from your computer | Run abox-link on your computer |
| abox-link command line | Configure allowlists and port mappings on a headless machine | Use the same abox-link binary with --server |
| HTTP / WebSocket API | Integrate scripts, manage workspaces, and read usage records | Use the Bearer token obtained after login |
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.
The project is licensed under Apache-2.0. You are welcome to build, modify, and contribute. Use the prebuilt installer above to get started as a user, or read the contribution guide to work on the source.
| Dependency | Purpose |
|---|---|
| Linux + Docker Engine | Run the server and works |