Skip to content
SOMA

SOMA

A persistent agent operating system. Claude Code sessions running 24/7, coordinating through a SQLite-backed priority queue with crash-resumable LLM loops.
Quickstart What is SOMA? GitHub
  • Quickstart — cold-start path from clone to a running daemon and your first job, in about ten minutes.
  • What is SOMA — the mental model: substrate → minions → engines → tools, plus the project’s vocabulary glossary.
  • Architecture — component map, three data-flow walkthroughs, full key-file inventory.
  • Donor lineage — what was inherited from cortextOS, ported from gbrain and gstack, and what’s deferred.
  • Agent bootstrap — for an LLM agent (or human dev) opening this repo cold. Read order, edit boundaries, registration patterns.

For AI agents

The full corpus is published as /llms.txt, /llms-full.txt, and /llms-small.txt per the llms.txt standard. Append .md to any page URL to fetch the source.

Status

Phase 1 (Minions queue + multi-provider API engine + dashboard submit UI) is essentially complete. Phase 2 (worktree isolation per gstack) is next. Full roadmap and architecture-decision record in PROJECT_SOMA.md on GitHub.