Local web application for AX: set up local or remote agent clusters, compose tasks with guardrails, monitor live execution, review and apply sandbox Git diffs locally, continue multi-turn sessions, and promote tasks across Kubernetes clusters.
AX Studio ships as a single Go binary (ax-studio) with an embedded React + TypeScript frontend served strictly on http://127.0.0.1:8080.
- Where Agents Run: Run host preflight checks and start a self-contained local Kind + Agent Substrate + AX sandbox (
ax local start), or connect directly to any remote team cluster in~/.kube/config(ax install) with zero local VM footprint. - Board & Activity: Monitor tasks grouped into
Needs You,Working,Suspended, andDone, inspect conditions, stream live logs, and open interactiveax sshterminal tabs. - New Task & Guardrails: Compose
Task,Workspace, andGatewaymanifests visually or in YAML, pick prebuilt agent templates, configure outbound HTTPS domain allow-lists, and store API keys as clusterSecrets (ax.io/credential: "true") injected byatenet-routerwithout exposing keys inside sandboxes. - Changes & Continue: Inspect uncommitted Git diffs inside a running debug-enabled sandbox (
spec.debug: true), discard individual files, apply patches directly onto a local Git repository (git apply --check), or launch a follow-up turn sharingspec.session_id. - Promote Across Clusters: Run a 5-check preflight (cluster reachability, Substrate version compatibility, manifest validation, remote credential Secrets, and uncommitted sandbox changes), push dirty working-tree files to a Git branch, and promote
Gateway+Workspace+Taskonto a team cluster.
axCLI installed (~/.ax/bin/axor onPATH).- For local sandboxes: Docker or rootful Podman on Linux (
>= 6.8kernel), or OrbStack / Docker Desktop / Colima on macOS. - For building from source: Go
1.27+(GOTOOLCHAIN=auto) and Node.js20+.
If you installed AX via install.sh, launch AX Studio directly:
ax studio # Opens http://127.0.0.1:8080 in your browserOr build and run from source:
npm ci
make build
./bin/ax-studioUseful flags:
./bin/ax-studio --port 8080 # Default loopback port (127.0.0.1:8080)
./bin/ax-studio --no-open # Do not open a browser automatically (SSH/remote or scripts)
./bin/ax-studio -n ax-system # Target a custom AX control-plane namespaceStopping ax studio / ax-studio (Ctrl-C) closes only the local web server; any local Kind cluster and running Tasks in Kubernetes continue running unaffected.
- Stop the Web UI: Press
Ctrl-Cin the terminal runningax studio/ax-studio. - Delete the local sandbox cluster (if created):
(Or click Delete on the Local Sandbox card in the Environments page before stopping AX Studio.)
ax local delete - Uninstall AX from a remote cluster (optional):
ax --context <remote-context> uninstall
- Remove local binaries and caches: All files installed by
install.shor cached on demand (ax,ax-studio, tunnel metadata, short-livedax sshcertificates, and any fallbackkind/kubectlbinaries not already on yourPATH) live under~/.ax/:Pre-existing system tools (rm -rf ~/.axdocker,podman, system/Homebrewkubectlandkind) and other~/.kube/configcontexts are never modified or removed. Removeexport PATH="$HOME/.ax/bin:$PATH"from~/.zshrcor~/.bashrcif you added it.
npm run dev # Vite dev server for frontend iteration
make test # TypeScript check + Go race-detector unit tests
make verify # make test + gofmt + go vet- Loopback-Only BFF: Refuses to bind to
0.0.0.0or non-loopback interfaces; rejects non-loopbackHostheaders (DNS rebinding defense) and cross-originOriginheaders. - Per-Process Session & CSRF: Issues an ephemeral 256-bit
HttpOnly; SameSite=Strictsession cookie and requires constant-timeX-AX-CSRF-Tokenverification on all mutatingPOSTendpoints, paired with strictContent-Security-Policy(script-src 'self'). - Allow-Listed Execution & Secret Redaction: Restricts subprocess calls to allow-listed
ax,kubectl,kind, andgitsubcommands, pipes credential Secret values strictly overstdin, and scrubs tokens from diagnostic logs.
