# lee-xeo/claude-cage

> claude-cage is a desktop app for running Claude Code inside an isolated virtual machine on your own computer. Its core idea is to place that virtual machine behind its own network proxy, and to open project folders, terminals and a browser together in one workbench. The main language is Go, with a browser-based interface and native desktop and mobile parts.

Source: https://github.com/lee-xeo/claude-cage
Indexed: commit 35d719f on 2026-11-17 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Go
- Stars: 7,068 at index time
- License: MIT
- Code health: 7.4/10, Good
- Last commit: 2026-11-16
- Contributors: 27

## How it works

The native shell in the desktop directory runs the app on the user's machine and checks for, downloads and installs newer versions. The browser interface in ui/src/main.jsx is where a user opens projects, runs Claude Code terminals, reads diagnostics and changes settings. The Go packages under internal create, run and inspect the sandboxed agent virtual machines, from the workbench down to the guest operating systems. cmd/agent-vm/main.go is one of the Go entry points, and agent-vm.sh defines the shell function that passes a user's arguments to the setup script that prepares the virtual machine. The mobile directory holds the phone app, which pairs with a computer and lets you browse projects, resume sessions and answer tool approval prompts.

- cmd/agent-vm/main.go: entry point
- cmd/cage-client/main.go: entry point
- cmd/cage-guest-boot/main_windows.go: entry point
- cmd/cage-guest-files/main.go: entry point
- cmd/cage-hyperv-manager/main_other.go: entry point
Modules: internal, third_party, ui, scripts, cmd, desktop, www, mobile. 2,668 files, 316,631 lines, 17,153 symbols.

## Code health

- Score: 7.4/10 (Good)
- Rank: #121 of 4,000+ indexed repos
- Hotspots: ui/src/main.jsx, agent-vm.sh, internal/workbench/safety.go, internal/workbench/server.go, internal/cage/browser-agent.mjs
- Lowest file: scripts/guest-os/windows-browser.mjs
- Dead code: 9 findings

## Maintenance

- Last commit 2026-11-16, first commit 2026-01-28, 440 commits
- 27 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/lee-xeo/claude-cage/security

## More

- Page: https://repowise.dev/repo/lee-xeo/claude-cage
- Ask this codebase: https://repowise.dev/repo/lee-xeo/claude-cage/chat
- Docs: https://repowise.dev/repo/lee-xeo/claude-cage/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/lee-xeo/claude-cage
