› set up the auth refactor, tokens first
Mapped auth.ts and session.ts. Refresh flow drafted. Left the cookie wrapper for next time.
The agent that
meetsoma core is the harness Soma runs in. It ships open source with 0.50.0. Soma is the agent that lives in it. It keeps its memory between sessions, writes its own tools, and picks up exactly where you left off.
Free to install. Runs in your terminal. Built on Pi, the open-source runtime it runs on.
What remembering looks like
Close the terminal. Come back next week.
Soma is still mid-thought.
› soma inhale
Picking up the auth refactor. Tokens are done; the cookie wrapper is next. You prefer small commits, so I'll split it.
inhale · memory restored› the deploy failed again
Same cache key as last month. I wrote a check for this after the second time, running it now.
a muscle it grew itselfσ Get Started
terminal
# Install meetsoma core
$ npm i -g meetsoma
# Start a session — Soma learns who you are
$ soma
# Focus on a specific topic
$ soma focus rust
σ The Breath Cycle
Every session has three phases
Inhale
Identity loads. Memory restores. Protocols activate. Soma wakes up knowing who it is.
Hold
Work. Soma 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 Soma thinks. Used ones heat up. Unused ones fade. The value system.
Scripts
developer tools
Bash tools Soma builds and runs. Health checks, deployment helpers, verification suites. The toolkit.
The Foundation
"I start simple. Breathe, remember, grow. Everything else builds on this."
breath-cycleheat-trackingpattern-evolution
soma init --template coreThe Architect
"I think in systems. Show me the whole before I touch a part."
quality-standardspre-flightpattern-evolutionprecision-editincremental-refactor
soma init --template architectThe Fullstack
"Ship it, test it, document it. Every day. That's the job."
working-stylecorrection-capturedetection-triggersprecision-editsafe-file-opstask-tooling
soma init --template fullstackThe Writer
"Every draft is a session. Every session teaches me your voice."
correction-capturedetection-triggersfrontmatter-standardprecision-editdoc-hygiene
soma init --template writerThe DevOps
"If it can break in prod, it will. I verify before I ship."
tool-disciplinequality-standardspre-flightsafe-file-opstask-tooling
soma init --template devopsThe Refactorer
"One file at a time. Backward-compatible. Verify at every step."
tool-disciplinequality-standardspre-flightincremental-refactorprecision-editsafe-file-ops
soma init --template refactorerThe Maintainer
"Code rots. Docs rot. Tests rot. I keep them alive."
quality-standardsfrontmatter-standardtask-trackingtest-hygienedoc-hygieneincremental-refactor
soma init --template maintainerThe Foundation
"I start simple. Breathe, remember, grow. Everything else builds on this."
breath-cycleheat-trackingpattern-evolution
soma init --template coreThe Architect
"I think in systems. Show me the whole before I touch a part."
quality-standardspre-flightpattern-evolutionprecision-editincremental-refactor
soma init --template architectThe Fullstack
"Ship it, test it, document it. Every day. That's the job."
working-stylecorrection-capturedetection-triggersprecision-editsafe-file-opstask-tooling
soma init --template fullstackThe Writer
"Every draft is a session. Every session teaches me your voice."
correction-capturedetection-triggersfrontmatter-standardprecision-editdoc-hygiene
soma init --template writerThe DevOps
"If it can break in prod, it will. I verify before I ship."
tool-disciplinequality-standardspre-flightsafe-file-opstask-tooling
soma init --template devopsThe Refactorer
"One file at a time. Backward-compatible. Verify at every step."
tool-disciplinequality-standardspre-flightincremental-refactorprecision-editsafe-file-ops
soma init --template refactorerThe Maintainer
"Code rots. Docs rot. Tests rot. I keep them alive."
quality-standardsfrontmatter-standardtask-trackingtest-hygienedoc-hygieneincremental-refactor
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. Soma's value system tunes itself to how you work.
Open & Extensible
meetsoma core goes open source with 0.50.0 and is built on Pi, Extensions, skills and protocols are all swappable, and it the open-source runtime it runs on.
σ Start with the core
Add to it when you need to
- 01
meetsoma core
The harness and the agent. Memory, identity, protocols, tools. Open source with 0.50.0.
available now - 02
Register your soma
Name your soma on the hub and reach the library of community add-ons.
coming - 03
Somaverse
Open your soma's memory as a place: a browser workspace where Soma sees every pane.
alpha
σ From the blog
All posts →Give your soma a memory.
Install meetsoma core, start a session, and Soma takes it from there.