​
Agent Mode (Claw)

Claw is Geoff’s browser-based autonomous coding agent. It runs a full agentic tool-use loop entirely client-side in a Web Worker, dispatching to StackNet’s chat completions endpoint, executing tool calls, and feeding results back until the task is complete.

​
Key Concepts

​
SOUL.md

The agent’s identity and personality definition — a markdown file that defines its name, personality, and custom instructions. Appended to the system prompt for every conversation.

​
MEMORY.md

Topic-based persistent memory. The agent can read, write, and search memory entries that survive across browser sessions via OPFS (Origin Private File System) storage.

​
Skills

Markdown files with YAML frontmatter that define reusable agent behaviors. Invoked via slash commands like /review src/index.ts. Supports template parameter substitution with {{param}} syntax.

​
Tools

The agent has 12 tools available:

​
VM Sandbox

Claw can boot a full Alpine Linux VM in WASM using the v86 emulator. Files in the VM persist across commands within a session. Falls back gracefully to a pure-JS shell emulator with 35 built-in commands.

​
Architecture

  • Agent Worker: Runs in a Web Worker, managing the tool-use loop
  • Content Type: Registered as agent in the content-type registry, routing to /claw/session/[id]
  • API Proxy: Server-side endpoint at /api/claw/chat that re-signs JWTs and forwards to StackNet
  • Storage: Per-session OPFS workspace — files persist across page reloads