Agent Control Plane

The Agent Control Plane is OpticWorks’ primary development environment. Sprites are hardware-isolated cloud VMs purpose-built for AI agent execution, replacing traditional developer workstations with persistent, checkpointable, and instantly-provisionable environments.

What is a Sprite?

A Sprite is a hardware-isolated execution environment for AI agents:

• Hardware isolation — True VM-level separation, not containers
• Persistent — State survives across sessions, can be checkpointed and restored
• Fast startup — ~1s cold start, instant when warm
• Pre-configured — Secrets, GitHub access, and AI tooling ready to go

Fleet Dashboard

Real-time Monitoring. The Fleet Dashboard shows live sprite health, API status, response times, and tool availability with auto-refresh.

Open Fleet Dashboard →

View health metrics, filter by team, monitor all sprites

Sprite Status

Semantic Name	Legacy Name	Purpose	Status
agents-review-claude-01	hammer	Git push reviewer (Claude)	Active
agents-review-codex-01	anvil	Git push reviewer (Codex)	Active
agents-synth-01	forge	RFD synthesis (Claude)	Active
dev-workspace-01	mallet	General workspace	Active
infra-bootstrap-01	test-sprite	Bootstrapper	Reserved
mobile-conductor-01	sprite-mobile-conductor	Distributed task conductor	Active
mobile-worker-01	sprite-mobile-worker-1	Worker node	Active
mobile-worker-02	sprite-mobile-worker-2	Worker node	Active

Reserved Sprites

Do not use agents-* sprites for general tasks — they’re dedicated to automated code review workflows triggered by git push. Use dev-workspace-* for ad-hoc work.

Quick Links

Fleet Dashboard Real-time sprite health and status monitoring.

Sprite Operations Provisioning, checkpointing, and execution.

Fleet Manager Pull-based fleet monitoring from N100.

Automated Code Review hammer/anvil review workflows.

Coder Workspaces Alternative: Traditional Coder setup.

Environment

Every sprite comes pre-configured with:

Resource	Location	Description
Secrets	~/.env.secrets	47+ variables, auto-sourced in bash
AI CLIs	claude, codex	Pre-authenticated, ready to use
GitHub	gh CLI	Authenticated, git push works
Repos	~/workspace/<repo>	Cloned during provisioning
Hardware	ssh n100	Via Cloudflare tunnel

Key Environment Variables

$GITHUB_TOKEN        # GitHub API access
$ANTHROPIC_API_KEY   # Claude API
$OPENAI_API_KEY      # OpenAI/Codex API

Quick Start

Run sprite-info inside any sprite to see your environment:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Sprite Environment
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Sprite:      mallet
  GitHub:      r-mccarty
  Secrets:     47 loaded (~/.env.secrets)
  Claude:      available
  Repos:       rs-1, hardwareOS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Monitored Repositories

The following repos are cloned to sprites and monitored for automated review:

Repository	Stack	Description
rs-1	ESP32 + LD2450	Presence sensor hardware
hardwareOS	Go + React	Embedded platform
opticworks-store	Next.js + Medusa	E-commerce
esphome-presence-engine	ESPHome	Presence detection
rv1106-system	Linux	RV1106 system images
n8n-marketing-automation	N8N	Marketing workflows

---

Source: agent-harness/CLAUDE.md, agent-harness/sprites-manifest.json