uuBright Console documentation
uuBright Console: your agents, within reach. It lets you run coding agents such as Claude Code and Codex on your own server and control them from a browser or phone. Start a task, close your laptop, and come back to its progress, approvals and results later. Your code, model access and Git credentials stay on your server.
It is built for people who use Claude Code with an Anthropic API key, on Amazon Bedrock or Google Vertex, or through a router such as Claude Code Router, and want to drive it from their phone on their own hardware. Anthropic's Remote Control and cloud sessions require a claude.ai account; uuBright Console uses whatever Claude Code configuration your server already has. Reach it through your own network or an end-to-end encrypted relay.
uuBright Console is made by uuBright. It is independent of Anthropic and Claude Code Router.
New here? On a Mac, start with the beta guide: install the app, run a first task and connect your phone. To run the server on your own Linux machine, see Getting started.
#Get started
- Developer beta: Mac and phone: install the signed uuBright Console Mac app, run a first task on This Mac, add a Linux host over SSH, and pair your phone.
- Getting started: install, connect from your laptop and run your first task.
- Bring your own model: connect an Anthropic API key, AWS Bedrock or Claude Code Router, with a free live check.
- How it works: the control plane, runners, execution modes and what each one can access.
- Security model: what a task can access, what uuBright Console enforces, and how to deploy it safely.
- Failure and recovery: what survives disconnects, restarts and crashes, and what doesn't.
#Guides
- Launch an AWS host: provision, stop/start, retain data and tear down.
- Back up and restore a workspace: one encrypted file with a workspace's tasks, conversations and uncommitted work, without credentials; restore it on another host.
- Work with repositories: use checkouts already on the server, add a repository by URL, and prepare each task with a setup script.
- Setup check: what the first run finds on your computer (recent repositories, Git identities, push credentials, GitHub CLI accounts, Claude Code Router) and how to fix what needs action.
- Run and control tasks: permissions, response style, approvals beside the message box, follow-ups, change review, pull requests, stop and resume.
- Continue a terminal session in a task: pick up a Claude Code or Codex conversation you started in a terminal, on This Mac or a host-mode server.
- Plugin settings, secrets and forms: a plugin's settings page, write-only secrets, and forms its tools ask you to fill in.
- Artifacts: publish, preview, approve and mark published a workspace's Deliverables.
- Codex host tasks: use the server account’s existing Codex CLI.
- Your Manager and its workers: the one agent you talk to in a workspace, the workers it starts, and the words the app uses.
- Shared rooms (preview): let several agents, including Codex on your laptop, share messages and a task list; a Manager's room is its Team log. You pass ordinary hand-offs on; a lead and its own workers pass theirs automatically.
- Switch models with CCR: use another model, such as an open-source one, while you're at a Claude usage limit.
- Access from your phone: Tailscale, your own domain with Cloudflare, or a VPN you already run, and pairing a phone with a one-time link.
- What you can do from your phone: phone vs Mac-only actions, drafts and pins that follow you, and the follow-up notification for an unanswered question.
- Access through an encrypted relay: QR pairing from a Mac, phone task list, and device revocation without ports or VPN.
- Several computers in one window: your Mac and a server side by side, with Needs you, the board and New task across both.
- Use the uuBright relay: sign in to the hosted relay and read its threat model.
- Notifications: approval and completion alerts, with Allow once and Deny buttons where the platform supports them.
- Discord control: an optional owner-only Discord bot.
- Docker and CCR sessions: isolated containers through a Claude Code Router gateway.
- Operate your server: updates, restarts, backups, logs and host resources.
#Reference
- Configuration: every setting in
server.env. - Command line:
setup,doctor,pair,github,resources,dev,relay, and thewechatandwhatsapppairing commands. - HTTP API: routes for scripts and other clients.
- Relay end-to-end protocol: versioned binary handshake, identity and key recovery.
- Troubleshooting: symptoms, checks and fixes.
#Current scope
uuBright Console is a single-owner beta. Host tasks support Claude Code and Codex. Several agents can work together in a room (preview).
Older links to the user guide and the operations reference still work; those pages point to where each section moved.
#Experimental channels
- Personal WeChat: optional iLink text control; real-account verification pending.
- Personal WhatsApp: experimental spare-number QR pairing, disabled by default.
#Feedback
Download uuBright Console from the public Mac beta page. Send questions, bugs and ideas to support@uubright.com. The web app links there too, from the ⋯ menu in its header.