RayTrace

See what your coding agent did: traces, tool calls, cost and step-by-step evidence for Claude Code and Codex, and sandboxes (cloud or local) to run them in.

This is the RayTrace CLI from npm (@raytrace-cli/cli), packaged for pip with its own Node.js, so you don't need Node installed. The command is raytrace.

pip install raytrace-cli    # or: uv tool install raytrace-cli / pipx install raytrace-cli

Local sandbox (your project stays on this machine)

No account needed. From a Git repository:

raytrace sandbox create --local              # a copy of this repo in a gVisor sandbox in a Linux VM
raytrace connect <name> --claude             # a terminal in it, with Claude Code running (or --codex)
raytrace open                                # the local dashboard: what the agent ran, read and connected to

The first one sets up the VM, which takes several minutes. Local sandboxes need Lima; raytrace sandbox create --local offers to download it. macOS and Linux; Windows is experimental. raytrace doctor shows what is missing.

Cloud sandbox

raytrace auth login                          # sign in, or create your account, in the browser
raytrace sandbox create                      # upload this Git repository to a new sandbox
raytrace connect <sandbox-id> --claude       # a terminal in it, with Claude Code running (or --codex)

Sessions show up at https://app.raytracer.si.

In your editor (MCP)

Your agent can create, open, list, start, stop and destroy local and cloud sandboxes for you. Claude Code:

claude mcp add --scope user raytrace -- uvx --from raytrace-cli raytrace mcp

Codex (~/.codex/config.toml), Cursor and others take the same command:

[mcp_servers.raytrace]
command = "uvx"
args = ["--from", "raytrace-cli", "raytrace", "mcp"]

Then ask your agent, for example, "put this repo in a local sandbox and open it".

Commands

raytrace help lists everything.

Uninstall

raytrace sandbox destroy <id or name>        # any sandboxes you no longer need
raytrace uninstall --purge                   # local sandboxes: deletes the VM and ~/.raytrace
raytrace auth logout
pip uninstall raytrace-cli
claude mcp remove raytrace -s user           # if you added the MCP server to Claude Code

Wheels are built for macOS 13.5+ (Apple Silicon and Intel), Linux with glibc 2.28+ (x86-64 and ARM64) and Windows (x64 and ARM64).

Full documentation: https://github.com/Godcreatebugs/raytrace-cli