repowiselee-xeo/claude-cage

Architecture of lee-xeo/claude-cage

lee-xeo/claude-cage is 2,668 source files holding 17,153 symbols across 13 modules, written mainly in Go, JavaScript, Shell. The largest module is internal, with 1,000 files, and 60 files are entry points into the dependency graph.

How claude-cage fits together

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.

Largest modules

  • internal: 1,000 files and 140,388 lines of code
  • third_party: 752 files and 87,539 lines of code
  • ui: 271 files and 40,568 lines of code
  • scripts: 216 files and 28,094 lines of code
  • cmd: 45 files and 4,816 lines of code
  • desktop: 30 files and 6,218 lines of code
  • www: 21 files and 1,587 lines of code
  • mobile: 20 files and 2,865 lines of code

Languages

By file count: Go 1,635 files, JavaScript 399 files, Shell 153 files, C# 64 files, Python 55 files, Swift 37 files.

Documentation

Repowise documents claude-cage in 1,792 pages generated from the source, 61 of them written explanations of the repository and its modules.

More on claude-cage: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos