Sσma v0.22.0
An AI agent that grows with you
Memory that persists across sessions. Identity that evolves through use.
Built on Pi. Extended with automations, muscles, protocols, and scripts. Yours to shape.
σ Get Started
σ The Breath Cycle
Every session has three phases
Inhale
Identity loads. Memory restores. Protocols activate. The agent wakes up knowing who it is.
Hold
Work. The agent tracks patterns, heats up what's used, cools what isn't. Context is managed automatically.
Exhale
Session state saves. Preloads write. Muscles crystallize. Nothing learned is lost.
Automations
triggered actions
Flows that fire on triggers — session start, post-commit, pre-deploy. The reflexes.
Muscles
learned patterns
Patterns learned from experience — deployment workflows, code conventions, API recipes. The muscle memory.
Protocols
behavioral rules
Rules that shape how the agent thinks. Used ones heat up. Unused ones fade. The value system.
Scripts
developer tools
Bash tools the agent builds and runs. Health checks, deployment helpers, verification suites. The toolkit.
The Foundation
"I start simple. Breathe, remember, grow. Everything else builds on this."
soma init --template coreThe Architect
"I think in systems. Show me the whole before I touch a part."
soma init --template architectThe Fullstack
"Ship it, test it, document it. Every day. That's the job."
soma init --template fullstackThe Writer
"Every draft is a session. Every session teaches me your voice."
soma init --template writerThe DevOps
"If it can break in prod, it will. I verify before I ship."
soma init --template devopsThe Refactorer
"One file at a time. Backward-compatible. Verify at every step."
soma init --template refactorerThe Maintainer
"Code rots. Docs rot. Tests rot. I keep them alive."
soma init --template maintainerThe Foundation
"I start simple. Breathe, remember, grow. Everything else builds on this."
soma init --template coreThe Architect
"I think in systems. Show me the whole before I touch a part."
soma init --template architectThe Fullstack
"Ship it, test it, document it. Every day. That's the job."
soma init --template fullstackThe Writer
"Every draft is a session. Every session teaches me your voice."
soma init --template writerThe DevOps
"If it can break in prod, it will. I verify before I ship."
soma init --template devopsThe Refactorer
"One file at a time. Backward-compatible. Verify at every step."
soma init --template refactorerThe Maintainer
"Code rots. Docs rot. Tests rot. I keep them alive."
soma init --template maintainerσ Why Soma
Memory Persists
Sessions end. Memory doesn't. Preloads, muscles, identity — flushed to disk
and picked back up next time. soma inhale to continue.
Identity Evolves
Not pre-configured. Soma's identity grows through use — voice, preferences, working patterns. Discovered, not assigned.
Protocols Adapt
Behavioral rules that heat up when used and fade when they don't. The agent's value system tunes itself to how you work.
Open & Extensible
Source-available under BSL 1.1. Built on Pi. Extensions, skills, protocols — all swappable. Works alongside CLAUDE.md and existing setups.
Start growing
Install Soma. Start a session. Let the memory build.