Repository Map

Path	Purpose
`src/cli.ts`	Main TypeScript implementation of the `x4` CLI.
`test/`	CLI integration and safety tests.
`scripts/`	Install/update/bootstrap helpers for devboxes, control nodes, workers, and Codex workspaces.
`registry/`	Repo set and sandbox registry templates.
`infra/`	Execution model, Tailscale policy templates, and secret/env templates.
`plugins/x4-codex/`	Codex plugin manifest and X4-specific skills.
`extensions/vscode-x4/`	VS Code/Cursor extension adapter.
`apps/mastra-orchestrator/`	Mastra GitHub bot and Code Assist workflows when working from a checkout that includes the Mastra app source. This X4 docs repo may instead reference the mirrored/deployed Mastra checkout.
`docs/`	Historical specs, handoffs, checklists, and deep implementation notes.
`documentation/`	Docusaurus documentation site.

Important State Paths

Path	Used by
`.x4/workspace.yaml`	Workspace metadata and selected repo set.
`.x4/issues.yaml`	Linked issue records.
`.x4/control-submissions/`	Local records of submitted control jobs.
`/srv/x4/control`	Control-plane jobs, leases, artifacts, and worker state.
`/srv/x4/workspaces`	Worker-side execution workspaces.
`/srv/x4/artifacts`	Worker-side job artifacts.
`apps/mastra-orchestrator/.code-assist/`	Mastra Code Assist SQLite state and implementation worktrees when the Mastra app source is present locally.