cuabot

Sandbox launcher for AI coding agents with computer-use

TLDR

Run the default agent in a sandbox

$ cuabot

Launch a specific agent (claude, codex, aider, openclaw, gemini, vibe)

$ cuabot [agent]

Run any command inside the sandbox

$ cuabot [command]

Start a named isolated session

$ cuabot -n [session_name] [agent]

Take a screenshot of the sandbox

$ cuabot --screenshot [path/to/output.png]

Click at specific coordinates

$ cuabot --click [x] [y]

Run a bash command inside the sandbox

$ cuabot --bash "[command]"

Start the background daemon

$ cuabot --serve [port]

Check daemon status

$ cuabot --status

SYNOPSIS

cuabot [options] [agent | command]

cuabot is a TUI launcher that runs any CLI coding agent (Claude Code, Codex, Aider, OpenClaw, etc.) or GUI application inside an isolated sandbox with computer-use capabilities. Each agent gets its own window streamed to the host desktop, with clipboard sharing and audio, while remaining isolated from the host system.The sandbox exposes a computer-use API so agents can take screenshots, click, type, scroll, and run shell commands inside the container. Multiple isolated sessions can run concurrently using -n, each with its own container and port.

OPTIONS

-n, --name name

Use a named isolated session (separate container and port).

--help

Show usage information.

COMMANDS

cuabot agent

Launch the named agent (e.g. claude, codex, aider, openclaw, gemini, vibe) in a sandbox.

cuabot command

Execute an arbitrary command inside the sandbox.

--serve [port]

Start the cuabotd daemon on the optional port.

--stop

Stop the running daemon.

--status

Print daemon status.

COMPUTER-USE OPTIONS

--screenshot [path]

Capture a screenshot of the sandbox display.

--click x y [button]

Click at the given coordinates with the optional button.

--doubleclick x y

Double-click at the given coordinates.

--move x y

Move the mouse to the coordinates.

--mousedown / --mouseup x y

Press or release a mouse button.

--drag x1 y1 x2 y2

Drag from one coordinate to another.

--scroll x y dx dy

Scroll at the given position by the given delta.

--type text

Type the given string.

--key key

Press and release a single key.

--keydown key / --keyup key

Press or release a key without releasing/pressing it.

--bash command

Run a bash command inside the sandbox.

CAVEATS

The sandbox is intended for AI agents that may execute arbitrary commands. While containerization isolates agents from the host, sharing the clipboard, microphone, or sensitive credentials into a sandbox can leak data. Treat the sandbox boundary as defense-in-depth, not a substitute for code review of agent actions.

HISTORY

cuabot is developed by trycua as part of the Cua project, an open-source platform for Computer-Use Agents. The tool aims to provide a uniform sandbox layer that any coding agent can plug into, decoupling the agent from the host environment.