Published Projects & Sites

Core Assistant & Standalone Runtimes

Personal AI agent that runs natively in the terminal, on mobile, desktop, and in the browser. Features real shell and filesystem access, local offline models and cloud LLMs, scheduled tasks, and a built-in MCP server bridge.

Published Pages & Guides:
  • ShadowClaw Pages (/main/) — Default workspace landing page and getting-started guide covering persistent agent memory (MEMORY.md), workspace file browsing and editing, page management, and chat settings.
  • Publishing to GitHub Pages (/docs/publishing/) — Comprehensive guide detailing automated static-site deployment strategies (full fork, pages-only, and CLI/npm), GitHub Actions workflows, custom domains, and deterministic in-browser Git publishing pipelines.
  • Agent Skills & Skill Creator (/docs/skill-creator/) — Guide and specification for authoring workspace agent skills and zero-LLM declarative tool pipelines with the /skill-creator command and $pipe data piping.
  • Article Example (/docs/example/article/) — Sample multimedia article demonstration featuring responsive embedded video playback, custom page styling, and Creative Commons licensing attribution.
  • Agent Memory (/main/memory/) — Workspace memory reference documenting folder layout conventions for agent skills (.agents/skills/), declarative JSON tools (.agents/tools/), and YAML frontmatter formats.

Zero-install, standalone single-file distribution of ShadowClaw encapsulated in a single HTML document (~64 KB). Powered by CDN-delivered modular ESM, browser-native Import Maps, OPFS, and in-browser local AI via WebGPU/WASM and the Prompt API.

Interactive Creative & Hardware Workbenches

In-browser Digital Audio Workstation (DAW) workbench and Web Audio API synthesis engine powered by ShadowClaw. Features TC39-shaped reactive Signals, Web Components (<scdaw-workbench>, <scdaw-transport>, <scdaw-mixer>, <scdaw-sequencer>), 15 declarative scdaw_* WebMCP audio tools, autonomous musical agent skills, Web Locks leader election, and high-speed offline WAV rendering.

Published Pages & Guides:
  • Interactive Workbench (/main/) — Direct-rendered pinned DAW workbench (scdaw.html), transport controls, multi-track mixer, step sequencer, and audio graph visualizers.
  • Audio Architecture (/main/architecture/) — Subsystem architecture separating pure musical logic, lookahead scheduling, Web Locks leader election (scdaw-engine), and Web Audio API lifecycle management.
  • Declarative WebMCP Tools (/main/tools/) — 15 declarative scdaw_* WebMCP tools for synthesis patching, track sequencing, pattern automation, channel mixing, and master bus control.
  • Autonomous Agent Skills (/main/skills/) — Declarative agent workflows conforming to the Agent Skills standard: /beat, /jam, /mixdown, /bounce, /scdaw-status, and /scdaw-doctor.
  • Reactive UI Components (/main/workbench/) — Component reference for custom elements synchronized via microtask-batched Signals and Web Worker IPC bridges.
  • Porting & Attribution (/main/porting-and-attribution/) — Provenance, sound generator architecture, and AGPLv3 licensing details.
  • Troubleshooting & Diagnostics (/main/troubleshooting/) — AudioContext user gesture requirements, Web Locks leader election recovery, and latency tuning.
  • Agent Memory (/main/memory/) — Workspace memory conventions, tool JSON manifests, and assistant persona definitions (Daw).

Hardware light meter sensory workbench, Web Bluetooth GATT telemetry engine, declarative WebMCP sensory tools, and autonomous agent skills for TinyDuino (ASM2001) + Bluegiga BLE112 (ASD2112) + KY-018 photoresistor.

Published Pages & Guides:
  • Interactive Workbench (/main/tinyduino/) — Real-time Web Bluetooth GATT telemetry workbench with dual-dial SVG gauges, scrolling waveform timeline, and live hardware controls.
  • Hardware Architecture (/main/hardware-architecture/) — 4-layer modular TinyDuino stack breakdown covering ASM2001, ASD2112 BLE112, ASD2101 USB, and ASD2009 Proto board.
  • Wiring & Schematics (/main/wiring-schematic/) — KY-018 3-pin routing, 10k pull-down divider circuit, and 3.3V logic rail safety analysis.
  • BLE112 BGAPI Protocol (/main/ble112-bgapi/) — Silicon Labs BGAPI protocol specification, GATT handles 17/20, packet structures, and BlueZ CCCD settling delay.
  • Calibration & Physics (/main/ky018-calibration/) — CdS photoconductivity power-law formulas, empirical verification points, and ADC-to-lux estimation curves.
  • Voltage Divider Math & Proof (/main/divider-math/) — Formal electrical derivation and native MathML proof demonstrating High A0 = Bright.
  • Wokwi Hardware Simulation (/main/wokwi-simulation/) — In-browser simulation with custom C-chip BLE112 emulation and step-by-step deployment guide.
  • Firmware Guide (/main/firmware-guide/) — 4x oversampled analog reader, non-blocking telemetry stream rate control, and BGLib host library integration.
  • WebMCP Sensory Tools (/main/webmcp-tools/) — 13 declarative WebMCP tools enabling browser AI agents to read illuminance, toggle LEDs, and stream telemetry.
  • Agent Skills (/main/agent-skills/) — Autonomous agent skills conforming to the open Agent Skills standard and instant slash commands.
  • Troubleshooting & Diagnostics (/main/troubleshooting/) — Diagnostic guide for BlueZ GATT error 133, Web Bluetooth flags, and USB break recovery.
  • Download Center (/main/download-center/) — Direct downloads for Arduino sketches, Wokwi simulation files, and JavaScript modules.

Starter Templates & Automated Pipelines

Starter template repository for authoring and deploying static websites, knowledge hubs, and custom agent skills driven by the ShadowClaw engine.

Published Pages:
  • ShadowClaw Template (/main/) — Starter landing page demonstrating how markdown and HTML files authored in pages/main/ are automatically pre-rendered into a static site via GitHub Actions.
  • About (/main/about/) — Overview page illustrating a content-only static site structure and demonstrating inter-page navigation within a ShadowClaw template project.
  • Agent Memory (/main/memory/) — Template memory reference outlining workspace conventions for skills, declarative JSON tools, portable ESM scripts (.agents/scripts/), and RFC v0.2.0 Agent Skills discovery.

Interactive Knowledge Hubs

Interactive documentation portal and technical reference guide for Block Garden—a 3D voxel sandbox exploration, procedural world generation, and farming game engine—featuring embedded custom elements, modding APIs, and in-game agent tools.

Interactive documentation platform and demonstration engine for the classic Unix pwgen password generator compiled to WebAssembly, featuring <x-pwgen> custom elements, entropy analysis, and declarative password-generation agent tools.

Static Publishing with ShadowClaw

ShadowClaw combines an interactive browser or Electron client with a headless Node.js agent, a local service layer, and external tool connections. The same agentic core, declarative skills, and tool pipelines can run across each environment.

Documentation

Read the public documentation index, including the architecture overview, CLI and static publishing guide, control plane reference, WebMCP guide, and MCP server reference.

Interactive Client

Run the browser-native PWA or Electron desktop app with orchestration, model calls, and tools isolated in a Web Worker. Client workspaces use OPFS and IndexedDB, with Web Components providing the interface.

# Start the interactive client with live reload
npx shadow-claw dev --open

Headless CLI Agent

Run the same reasoning loop directly from a terminal or CI pipeline. The CLI uses Node.js, native filesystem access, SQLite persistence, host shell execution, and local or cloud model providers.

# Initialize a workspace and run a headless prompt
npx shadow-claw agent init ./my-project
npx shadow-claw agent --workspace ./my-project run "summarize this workspace"

# Inspect available headless-safe tools and skills
npx shadow-claw agent tools
npx shadow-claw agent skills

Server & Control Plane

Run the backend independently of the frontend. The Express service exposes the proxy, scheduler, REST control plane, and MCP endpoint so static sites, browser tabs, CLI commands, and external clients can share a local or remote backend.

# Start services without building or serving a frontend
npx shadow-claw server

Drive Connected Clients

The control plane turns connected browser and Electron clients into remotely addressable execution surfaces. From the CLI, you can list clients, send prompts, inspect scheduled tasks, read client state, and create or manage OPFS workspace backups.

# Discover and operate connected clients
npx shadow-claw clients
npx shadow-claw send "summarize the active workspace" --client <id>
npx shadow-claw tasks --client <id>
npx shadow-claw backup
npx shadow-claw backup list

WebMCP & External Agents

In supported browsers, ShadowClaw registers its tool catalog on document.modelContext through WebMCP and routes execution through the Web Worker. External AI clients can use the official MCP server over Streamable HTTP or the CLI STDIO bridge, while connected clients communicate with the control plane over SSE, WebSocket, or peer-to-peer WebRTC DataChannels.

# Connect an MCP-compatible desktop client over STDIO
npx shadow-claw mcp

# Start a direct peer-to-peer WebRTC listener
npx shadow-claw webrtc listen

Static Publishing

Content repositories use ShadowClaw's dual-root build pipeline to combine the shared runtime bundles with their own pages, assets, configuration, skills, and tools:

# Start local development server on http://127.0.0.1:8888
npx shadow-claw dev

# Or compile static production distribution into ./dist/public
npx shadow-claw build --prod

Deployment Strategies