Use this page to choose the shortest path to the information you need. The repository README stays focused on what Spynel is; operational and implementation detail lives here.
- Getting started and development — install, initialize a workspace, run from source, and verify a development checkout.
- Configuration — workspace, harness, interface, channel, speech, startup, orchestration, and extension settings.
- Communication integrations — TUI, Telegram, WhatsApp, voice, histories, and transport behavior.
- Troubleshooting — common installation, harness, channel, startup, update, and speech problems.
- Tasks and goals — durable Markdown workflows, review, recovery, waiting, and notifications.
- Plain CLI and automation — messages, follow-ups, conversations, status, framework commands, and output contracts.
- Agent-readable documentation — the offline
spynel docsinterface and its versioned JSON schema. - Persistent per-agent instructions — workspace-level preferences, role mapping, and precedence.
- Extensions and hooks — trusted executable extensions and delivery guarantees.
- Product vision — positioning, product boundaries, and the three pillars.
- Architecture — application, process, history, harness, channel, and orchestration design.
- Coding harness compatibility — evidence-backed lifecycle coverage and known gaps.
- Provider-canary threat model — controls for authenticated provider testing.
- Releasing — native packaging, npm publication, credentials, and release verification.