wanix-acp

Run any agent inside a wanix sandbox in a browser tab — everything except the brain.

Your agent implements one small Go interface (wanixacp.Runtime), compiles to wasm, and runs as a task in the page: the repo, a Linux VM, and the task namespace live in the tab; a native backend (wanixserver) serves the filtered repo export, the log mirror, and the page, as plain HTTP or a Wails window. A plain JS web worker can plug in instead — no Go required.

bin/vendor-static     # fetch the wanix browser files (npm)
bin/build-demo-wasm   # build the demo brain
go run ./cmd/demo     # serve at http://localhost:8478

cmd/demo is a complete minimal brain to copy from. See AGENTS.md for the contract, the package layout, and the architecture doc pointer.

Known issues

Still experimenting!

• ACP isn't implemented yet (just an internal agent).
• TinyGo isn't used because of a bug creating new files.
• File operations are slow really slow, so agents are encouraged to route tool calls to wanixserver.
  • See the content cache middleware task for a potential improvement.