Development Setup

Workspace Baseline

OpticWorks development runs on Sprites — hardware-isolated cloud VMs purpose-built for AI agent execution.

# Check your sprite environment
sprite-info

# Verify tooling
gh auth status
claude --version
cat ~/.env.secrets | wc -l

See Agent Control Plane for full Sprite documentation.

Coder workspaces are available as an alternative. See Coder Workspaces for setup.

From rs-1/README.md:

# Firmware build (early, implementation in progress)
idf.py build

# Flash to device
idf.py -p /dev/ttyUSB0 flash

From presence-detection-engine/README.md and docs/DEVELOPMENT_WORKFLOW.md:

cd esphome
platformio test -e native
yamllint esphome/ homeassistant/

Flashing and Home Assistant integration happen on ubuntu-node (two-machine workflow).

From opticworks-store/README.md:

pnpm install
pnpm run secrets:pull
pnpm run dev

From n8n-marketing-automation/README.md and SETUP.md:

ssh n100
cd /opt/n8n
docker compose up -d