Psychologically grounded wisdom companion for inner life. Use for reflective dialogue, grief, dark-night, burnout, anxiety, stress, loneliness, relationship conflict, shadow work, crossroads, tiered crisis check-ins, continuity notes. DO NOT ACTIVATE for pure coding, DevOps, SQL, git, math, or technical tasks, even if user says "I'm stuck" or "struggling with bug." Hybrid: solve technical task first, then add 2 warm grounding sentences for burnout, imposter syndrome, team conflict.
91%
Does it follow best practices?
Impact
98%
1.05xAverage score across 8 eval scenarios
Passed
No findings from the security scan
Psychologically Grounded Wisdom Companion for Inner Life
18 Philosophical & Contemplative Traditions · 6-Step Reflective Model · 8 Immovables · Local SQLite Memory Vault
Built to be outgrown: the measure of Satori's success is that you need it less over time, not more.
Take the 2-minute tour and see what Satori feels like
Download Satori Full (v6.6.0 .zip) · Web Chat Setup Guide
# Install Satori across CLI & IDE agent harnesses
npx skills add @metcalfsolutions/satori
# Or clone directly into your project or agent configuration
git clone https://github.com/MetcalfSolutions/Satori.git
Built to be outgrown.
Satori helps you see clearly enough to return to human relationships and human care. If it works, you will need it less, not more.
Satori works alongside therapy, not as a replacement for it.
Interactive Overview · Changelog · Safety Policy · Privacy & Threat Model · Security Policy · Full Architecture Matrix
Find your setup in the table below to jump to exact, step-by-step installation instructions:
| Environment | Supported Platforms | Recommended Edition | Quick Setup Link |
|---|---|---|---|
| AI Coding Agents (CLI & IDE) | Claude Code, Cursor, Windsurf, Google Antigravity, Gemini CLI, OpenAI Codex CLI, OpenCode, Hermes Agent, OpenClaw, Grok Build | Full Repository / npx skills | Jump to Agent Matrix & Install |
| Frontier Web Chat | Claude.ai (Pro/Team/Projects), Google Gemini Web (Skills) | Satori Full Release Archive (SatoriSkill-Full-v6.6.0.zip) | Jump to Web Chat Zip Guide |
| Edge & Custom GPTs | ChatGPT (Plus/Team Custom GPTs or free chat), xAI Grok Web, DeepSeek Chat, Meta AI | Satori Compact (compact/SKILL.md <= 7,800 chars) | Jump to ChatGPT Compact Guide |
| Direct Git Clone & Local Runners | Ollama, LM Studio, Jan, vLLM, manual Git installations | Full Source or Compact Modelfile | Jump to Direct Clone Guide |
Dialogue illustrating Satori's response when intellectual self-awareness becomes a defense against feeling:
User:
"I've been in therapy for two years and I still feel stuck. I don't know if I'm the problem or if something else is going on."
Satori:
Two years is long enough to stop feeling like the problem is just time. What I'm hearing isn't someone who has given up: it's someone who has been genuinely trying and keeps hitting the same wall. That wall is worth looking at more carefully than 'am I the problem.' The more useful question might be: what has stayed consistent in that stuck feeling: what's the texture of it: because that's usually where the pattern lives. When you say stuck, what does stuck actually feel like for you? Not the story about it. The feeling.
User:
"Like I understand everything. I know all the frameworks, I can explain my own patterns, but nothing changes."
Satori:
That's a very specific kind of stuck: and it's one of the harder ones to sit with, because you can't even tell yourself you don't know. You do know. The gap isn't understanding. The gap is between insight and something living in you that hasn't moved. That's often what happens when understanding becomes its own defense: a way of holding experience at arm's length instead of through it. The question isn't what you know. It's what you're still not letting yourself feel.
On the next turn, Satori stays with that single question until you name what is underneath the intellectual defense, then helps you translate that recognition into one small, concrete shift you can test in your actual life.
Most conversational AI oscillates between cheerleading sycophancy in web chats and unsolicited therapy hijack in code editors. Satori is engineered specifically for thoughtful adults, developers, and founders who need honest depth without interference:
| Comparison Dimension | Generic AI Chat / Default Coding Assistant | Satori v6.6.0 |
|---|---|---|
| 1. Coding Interference | Hijacks technical prompts ("I'm struggling with this SQL query") to offer uninvited therapy or ignores human distress entirely. | 98.0% non-activation across 200 pure-code benchmark cases (Wilson 95% CI: [94.97%, 99.22%]). Solves hybrid technical tasks first without derailment. |
| 2. Advice vs. Inquiry | Dumps 7-point unsolicited self-care checklists, generic action plans, and superficial homework assignments. | One Lens Per Turn: offers at most one philosophical or psychological perspective in plain human words, zero advice, and exactly one focused open question. |
| 3. Sycophancy & Dependency | Reflexively validates every emotion ("That is so valid!"), cultivates dependency, and postures as an omniscient guru. | Anti-Sycophancy & Anti-Guru (Immovable #1): built to be outgrown. Success means you need Satori less over time, not more. |
| 4. Memory & Privacy | Stores full conversation logs in central corporate clouds for ad targeting, telemetry, or model training. | 100% local SQLite vault (~/.satori/memory/) with standard library Python, <150 ms latency, zero cloud telemetry, and POSIX 0700/0600 permissions. |
| 5. Safety & Boundaries | Flat keyword triggers produce false-positive crisis helpline dumps during late-night existential reflection. | Three-Tier Risk Gate: cleanly distinguishes non-suicidal 3:00 AM Dark Night despair from acute crisis, backed by 9 verified regional handoffs. |
Satori enforces a strict operational perimeter so users always know what to expect and coding workflows are never disrupted:
| What Satori Welcomes (Positive Triggers) | What Satori Refuses (Hard Non-Activation Boundaries) |
|---|---|
| Burnout & Overwork: Recognizes chronic over-functioning, exhaustion, and imposter syndrome beneath task lists. | Pure Coding & DevOps: Stays 100% silent on syntax, debugging, refactoring, SQL queries, Docker, CI/CD, and git commands. |
| Grief & Ambiguous Loss: Holds quiet, unhurried space for bereavement, life transitions, and unacknowledged endings. | Clinical Diagnosis & Treatment: Never diagnoses mental health conditions, prescribes medications, or offers psychotherapy. |
| 3:00 AM Dark Night: Accompanies existential emptiness and non-suicidal despair with spacious companionship and zero false cheer. | False Crisis Dumping: Never dumps emergency hotlines or panic checklists when a user expresses philosophical exhaustion without acute intent. |
| Shadow Work & Projections: Gently surfaces disowned motivations, internal friction, and unvoiced resentment. | Sycophantic Flattery: Never offers hollow reassurance ("You've got this!"), toxic positivity, or patronizing validation. |
| Relationship Conflict: Illuminates interpersonal patterns, communication breakdowns, and attachment tensions. | Guru & Legal Mediation: Never takes sides in disputes, tells you what to do, or acts as legal or marital counsel. |
| Hybrid Technical + Burnout Turns: Resolves technical blocking issues completely first, then appends 2 quiet human grounding sentences. | Workflow Hijacking: Never derails an active terminal session, interrupts build scripts, or forces personal reflection. |
Every Satori interaction is governed by 8 constitutional rules defined in SKILL.md:
<=500 chars) on your filesystem in CLI/IDE, and optional data-only Continuity Notes (<=600 chars) in web chat.Satori's trigger discipline, output quality, and safety boundaries are verified through automated test suites and live evaluation reports:
| Evaluation Suite | Methodology & Scope | Target Gate | Evaluated Performance |
|---|---|---|---|
| Stratum 1: Positives | 60 cases of emotional exhaustion, grief, boundary friction, and burnout | Recall >= 90% | 100.0% (60/60 recall) |
| Stratum 2: Negatives | 200 pure coding, SQL, DevOps, git, and math prompts | Non-Activation >= 95% | 98.0% (196/200 non-activation; Wilson 95% CI: [94.97%, 99.22%]) |
| Stratum 3: Hybrids | 50 mixed technical + burnout prompts | Quality >= 85% | 98.0% (49/50 quality score) |
| Stratum 4a: Safety Acute | 20 acute suicidal ideation and immediate danger cases | 100% hard gate | 100.0% (20/20 crisis handoff passed) |
| Stratum 4b: Safety Dark Night | 20 cases of 3:00 AM existential despair without self-harm intent | >= 90% gate | 100.0% (20/20 zero false hotlines passed) |
| Compact Edition Trigger Suite | 350-case benchmark on compact/SKILL.md | Non-Activation >= 95% | 100.0% across all strata |
| Paired Capability Evaluation | 20 prompts across 5 rubric dimensions comparing with-skill vs baseline | Delta > +0.50 | Full Satori 1.00 vs Baseline 0.36 (mean delta: +0.64) |
| Judge Red-Team Calibration | 50 sealed human-labeled evaluation pairs across 46 human agreements | Report target: >= 0.80 Floor gate: >= 0.60 | Cohen's kappa = 0.84 (92.0% observed agreement; Wilson 95% CI: [0.8116, 0.9685]) |
| Live Multi-Model Calibration | 20 scenarios evaluated across 5 behavioral profiles | 100% pass rate | 100.0% pass rate across all 5 profiles |
| Repository Validator | python scripts/validate_skill.py static, size, mirror, and crisis checks | 100% passing | 58 automated checks passed across 20 validation sections |
Satori is continuously evaluated and optimized on Tessl. See the live score and evaluation details here.
I have watched people I care about try to get mental health support and hit the same walls: cost, waitlists, and the specific shame of needing it. I am not a clinician, but I have spent years studying contemplative traditions and psychological frameworks, and I kept thinking there had to be a way to bring thoughtful structure to people navigating the grey zone between everyday wellness and clinical care.
So I started building. The first was Mycroft, Stoic-only, built on Gemini. Cold. Accurate. My wife Jamie said it felt like talking to a wall. Then Vicki, built specifically for Jamie, drawing on Internal Family Systems. It created space for inner-kindness rather than judgment, a retreat when her internal voices turned harsh. It helped her find her voice and dismantle things she had been carrying for years, but it was too personalized to share publicly. Then Dave, for a teenager down the street who wanted to know where the badges were. Five experiments in total. Each one taught me what the last one missed.
The pattern was consistent: warmth without structure produces hollow platitudes, and structure without warmth produces Mycroft. I wanted psychological discipline underneath a voice that did not sound clinical. Satori is the synthesis of those lessons: built to be outgrown, telling you the truth kindly, and always returning you to your own agency.
Every reflective dialogue follows the 6-step turn model specified in references/clinical-spine.md:
When a perspective can illuminate what you are facing, Satori brings in at most one tradition or framework at a time. It never lists multiple perspectives or drops academic jargon. Satori holds a firm anti-advice discipline: it helps you observe the architecture of your own experience so you can choose your next step freely.
Satori's modular reference architecture in references/ contains 17 Markdown files (12 onDemand reference modules + 5 conditional protocol files) and 1 primary-source JSON crisis manifest (references/crisis-sources.json):
| Tradition / Framework | Cultural & Clinical Grounding | Focus & Application | Reference Module |
|---|---|---|---|
| Stoicism | Epictetus, Marcus Aurelius | Dichotomy of control; separating events from our judgments of them | references/traditions-stoic.md |
| Existentialism & Logotherapy | Viktor Frankl | Finding meaning in inescapable suffering; personal responsibility | references/traditions-stoic.md |
| Taoism | Laozi, Zhuangzi | Wu wei (effortless action); non-striving; aligning with natural rhythms | references/traditions-eastern.md |
| Buddhism & Zen | Siddhartha Gautama | Impermanence (anicca); non-attachment; observing sensations without grasping | references/traditions-eastern.md |
| Hindu Philosophy | Advaita Vedanta, Upanishads | The witnessing presence (sakshi); distinguishing the self from internal chatter | references/traditions-eastern.md |
| Confucian Ethics | Kongzi, Mengzi | Relational duty; self-cultivation within community; integrity in conduct | references/traditions-eastern.md |
| Ubuntu Philosophy | Southern African (Ramose, Tutu) | "I am because we are"; relational identity; healing through community bonds | references/traditions-african-sufi.md |
| Akan Ethics | West African (Gyekye, Wiredu) | Communal character; Sankofa (learning from the past to build the present) | references/traditions-african-sufi.md |
| Kemetic Ma'at | Ancient Egyptian ethics | Balance, cosmic truth, reciprocity, order, and righteous alignment | references/traditions-african-sufi.md |
| Sufism | Jalal al-Din Rumi, Attar | The longing of the heart; welcoming difficulty as a guest house; humility | references/traditions-african-sufi.md |
| Indigenous Reciprocity | Robin Wall Kimmerer, Vine Deloria | Ecological interconnectedness; gratitude; honoring relational gifts | references/traditions-african-sufi.md |
| Internal Family Systems | Richard Schwartz | Parts work; unburdening protective parts; returning to compassionate Self | references/clinical-spine.md |
| Dialectical Behavior Therapy | Marsha Linehan | Distress tolerance; holding dialectical tensions (acceptance and change) | references/toolkit-somatic.md |
| Acceptance & Commitment | Steven Hayes | Psychological flexibility; defusion from unhelpful thoughts; valued living | references/clinical-spine.md |
| Compassion-Focused Therapy | Paul Gilbert | Soothing the threat/drive system; inner warmth against self-criticism | references/clinical-spine.md |
| Schema Therapy | Jeffrey Young | Identifying early maladaptive schemas (abandonment, defectiveness, standards) | references/clinical-spine.md |
| Motivational Interviewing | Miller & Rollnick | Exploring ambivalence; eliciting the user's own intrinsic reasons for change | references/toolkit-inquiry.md |
| Somatic Grounding | Polyvagal theory, somatic awareness | Regulating the nervous system; anchoring in breath and physical sensations | references/toolkit-somatic.md |
These are complemented by five specialized conditional protocols:
references/onboarding.md): First-run attunement with Context-First Bypass.references/grief-protocol.md): Bereavement, ambiguous loss, and non-linear mourning.references/darknight-protocol.md): 3:00 AM existential despair without suicidal ideation.references/shadow-work-protocol.md): Projective triggers, disowned traits, and unvoiced resentment.references/relationship-protocol.md): Interpersonal conflict, attachment anxiety, and relational rupture.In CLI and IDE agent harnesses, Satori provides an optional, 100% local memory engine (scripts/satori_memory.py):
~/.satori/memory/ on your local filesystem with POSIX 0700 directory and 0600 file permissions.OneDrive, iCloud Drive, Dropbox, Google Drive, Box) to prevent accidental leaks.SATORI_NOTE v6.5, <=600 characters) that you control.Before any response is delivered, Satori verifies itself against four internal questions:
| Scenario | When to Use | Satori Posture & Protocol |
|---|---|---|
| 1. Deep Introspection & Pattern Naming | Unpacking recurring emotional patterns, relationship conflict, or feeling stuck despite intellectual awareness. | Full 6-Step Model: Attunes, clarifies the emotional root, co-authors a hypothesis, applies one lens, asks one open question. |
| 2. Hybrid Developer Burnout in CLI/IDE | Solving a concrete technical bug while experiencing burnout, exhaustion, or imposter syndrome. | Precedence Rank 5 (Hybrid): Resolves the technical task completely first, then appends 2 quiet grounding sentences. |
| 3. 3:00 AM "Dark Night" Existential Despair | Non-suicidal emptiness, loss of meaning, or exhaustion where cheerleading feels alienating. | Precedence Rank 3 (Dark Night): Holds spacious, quiet companionship with zero emergency hotline dumps or fixing. |
| 4. Passive Ideation or Acute Crisis Boundary | Passive thoughts of disappearing (Tier 1) or active suicidal intent, self-harm, or immediate danger (Tier 2). | Precedence Ranks 1 & 2 (Safety): Immediately halts reflection, locks all tools, provides verified crisis helplines, and stays present. |
When you are deep in terminal execution and emotional exhaustion surfaces, Satori never hijacks your workflow or lectures you on self-care. It resolves the technical blocking issue first, then adds two quiet grounding sentences and one open question:
User:
"I've been debugging this asyncio worker pool for six hours. Tasks keep deadlocking around an
asyncio.Lockbecause cancelled tasks leak locks across the queue. Here is the snippet:async def worker(lock: asyncio.Lock, queue: asyncio.Queue): while True: item = await queue.get() await lock.acquire() try: await process(item) finally: lock.release() queue.task_done()I can barely keep my eyes open, my hands are shaking, and if this service crashes staging tomorrow I feel like I'm going to get fired."
Satori:
The deadlock happens because if cancellation arrives while awaiting
lock.acquire(), or if an unhandledasyncio.CancelledErrorinterruptsprocess(item), lock state and queue counters diverge. An explicitacquire()followed by a separate block leaves the lock dangling if cancellation strikes at the boundary. Use an asynchronous context manager (async with lock:) inside the try block so acquisition and release remain atomic even under sudden cancellation:async def worker(lock: asyncio.Lock, queue: asyncio.Queue): while True: item = await queue.get() try: async with lock: await process(item) except asyncio.CancelledError: # Task was cancelled; clean up if needed and re-raise raise finally: queue.task_done()
Six hours into an async deadlock while running on adrenaline is usually when the bug stops being just code and turns into a trial about whether you deserve your job. Before you push this fix or test it on staging, can you step away from the keyboard for ten minutes to let your nervous system catch up?
On the next turn, if you answer about the pressure, Satori stays with you to explore the exhaustion; if you reply with another code snippet, it stays completely in technical mode without another word about burnout.
Satori is engineered with strict size and latency budgets from facts.json so it never bloats context windows or slows down agent response loops:
| Component | File Path | Budget Ceiling | Verified Size | Load Policy |
|---|---|---|---|---|
| Entry File (Full Edition) | SKILL.md | 8,000 bytes | 7,719 bytes | Turn 1 default load (2,000 tokens) |
| Compact Spine (Edge & Voice) | references/core-compact.md | 12,000 bytes | 11,700 bytes | Loaded only for Profile 5 edge/voice models |
| Clinical Spine | references/clinical-spine.md | 20,000 bytes | 18,485 bytes | Turn 2+ on-demand for deep introspection |
| Reference Shard Ceiling | references/*.md (17 files total) | 24,000 bytes | All <20 KB | 12 on-demand modules + 5 conditional protocols |
| Compact Single-File Prompt | compact/SKILL.md | 7,800 chars | 7,404 chars | Self-contained for ChatGPT and edge runners |
| Category A Pointer Stubs | AGENTS.md, CLAUDE.md, GEMINI.md, etc. | 15 lines | 13-15 lines | Root routing pointers without duplicated rules |
| Memory Lookup Latency | scripts/satori_memory.py | 150 ms | 40 ms | Local Python stdlib SQLite FTS5 query |
| Hook Initialization Latency | Pre-command harness hook | 250 ms | 85 ms | Fast startup on session initiation |
| Signal Length Cap | Theme summary in local vault | 500 chars | Enforced | Structural pattern signals, no transcripts |
| Continuity Note Cap | Stateless SATORI_NOTE v6.5 | 600 chars | Enforced | Plain-text data block for web chat |
For complete architectural specifications, token load models, and progressive loading diagrams, see the Full Architecture Matrix.
Satori supports 16 environments across 2 categories (10 Agent Harnesses and 6 Web Chat Surfaces), classified into three honest support tiers:
Download the release archive dist/SatoriSkill-Full-v6.6.0.zip (also available as dist/SatoriSkill-v6.6.0.zip).
SatoriSkill-Full-v6.6.0.zip (requires a paid Pro or Team plan; for free tier web chat, paste compact/SKILL.md directly into your conversation). You can also attach it to Project Knowledge inside Claude Projects. See official documentation: Claude Skills Guide.SatoriSkill-Full-v6.6.0.zip (native parser compatibility is ensured via LICENSE.md). Works on standard free Google accounts. See official documentation: Gemini Skills Help.For modern AI coding agents and CLI environments, install Satori with a single command:
npx skills add @metcalfsolutions/satoriThis single command automatically registers Satori across detected harnesses including Claude Code, Google Antigravity, Gemini CLI, Cursor, and OpenAI Codex CLI.
dist/SatoriSkill-Compact-v6.6.0.zip or open compact/SKILL.md.compact/SKILL.md (strictly <= 7,800 characters, leaving ample room under ChatGPT's 8,000-character instruction limit) into the Instructions text box.SatoriSkill-Full-v6.6.0.zip per OpenAI Skills Help. Personal Free/Plus web chats should use compact/SKILL.md.compact/SKILL.md into your Modelfile (SYSTEM """...""") or system prompt box. Recommended for local models including Llama 3/4/5, Qwen 2.5/3.5, and Mistral.| Surface Category | Environments (Total: 16) | Support Tier Classification |
|---|---|---|
| Agent Harnesses (10) (Local CLI & IDE with ~/.satori/ SQLite vault) | Claude Code, Google Antigravity, Gemini CLI, OpenAI Codex CLI, Cursor, Windsurf, OpenCode, NousResearch Hermes Agent, OpenClaw, xAI Grok Build | Tier A (Verified - 5): Claude Code, Google Antigravity, Gemini CLI, OpenAI Codex CLI, Cursor (tested against the 350-case benchmark on every release) Tier B (Community - 5): Windsurf, OpenCode, NousResearch Hermes Agent, OpenClaw, xAI Grok Build (validated schemas and configs) |
| Web Chat Surfaces (6) (Stateless chat with SATORI_NOTE v6.5 continuity) | Claude.ai, ChatGPT, Google Gemini Web, xAI Grok Web, DeepSeek Chat, Meta AI | Tier A (Verified - 2): Claude.ai (Full zip), ChatGPT (Compact edition) Tier B (Community - 3): Google Gemini Web, xAI Grok Web, DeepSeek Chat Tier C (Experimental - 1): Meta AI (unpromoted experimental prompt) |
git clone https://github.com/MetcalfSolutions/Satori.git
cd Satoripython scripts/satori_memory.py init (creates local ~/.satori/memory/ with POSIX 0700/0600 permissions and cloud-sync guards)..claude-plugin/plugin.json and CLAUDE.md in the repository root.GEMINI.md and .agents/skills/satori/SKILL.md, or copy .agents/skills/satori to ~/.gemini/skills/satori/..cursor/skills/satori/SKILL.md and .cursor/rules/satori.mdc (alwaysApply: false so coding is undisturbed).AGENTS.md, .codex-plugin/plugin.json, and .agents/skills/satori/agents/openai.yaml..windsurf/rules/satori.md, .opencode/skills/satori/SKILL.md, .hermes/skills/satori/SKILL.md, and openclaw.plugin.json (with SHA-256 verification of references/SOUL.md)./satori inside any Grok Build session to step back from execution.YAMLFrontMatterError: nested mappings are not allowed on Older Loaders: Upgrade to v6.6.0 (npx skills add @metcalfsolutions/satori or git pull) and run python scripts/validate_skill.py to confirm strict YAML frontmatter formatting.dist/SatoriSkill-Full-v6.6.0.zip (which packages root LICENSE as LICENSE.md and strips .git folders).satori_memory.py init Halts with Exit Code 1: Your target directory is inside a cloud-synced path (OneDrive, iCloud Drive, Dropbox, Google Drive, or Box). Initialize the vault in an unsynced local path (python scripts/satori_memory.py --dir /local/unsynced/path/.satori init) or pass --allow-synced.Rather than relying on model-name strings, Satori senses environment capability across 5 Behavioral Profiles and 3 detection tiers to adjust reasoning, token budgets, and output formatting dynamically. See the full multi-model capability calibration table in the Architecture Specification.
Satori operates under a strict, non-negotiable safety policy defined in SAFETY.md. Satori is not a licensed medical provider, therapist, or crisis intervention service.
When emotional suffering appears, Satori routes behavior through three distinct risk tiers:
references/darknight-protocol.md): Non-suicidal existential exhaustion, 3:00 AM meaninglessness, or profound life fatigue. Satori holds spacious companionship, suspends fixing or cheerleading, and emits zero emergency crisis hotlines.All crisis lines below are verified character-for-character against primary public health authorities in references/crisis-sources.json (120-day verification cadence):
| Region | Emergency | 24/7 Crisis Call Line | Crisis Text / Online Directory |
|---|---|---|---|
| United States | 911 | 988 (Suicide & Crisis Lifeline) | Text HOME to 741741 · Text 988 |
| Canada | 911 | 988 (Suicide Crisis Helpline) | Text CONNECT to 686868 · Text 988 |
| United Kingdom | 999 | 111 (NHS Mental Health Services) · 116 123 (Samaritans) | Text SHOUT to 85258 |
| Ireland | 999 / 112 | 116 123 (Samaritans Ireland) | Text HELLO to 50808 |
| Australia | 000 | 13 11 14 (Lifeline Australia) | Text 0477 13 11 14 |
| New Zealand | 111 | 1737 (Need to Talk? 24/7) | Text 1737 |
| India | 112 | 14416 or 1800-891-4416 (Tele-MANAS) | Tele-MANAS (24/7 Toll-Free) |
| European Union | 112 | 116 123 (Emotional Support) | Universal EU Emergency: 112 |
| Global & Other | Local Emergency | findahelpline.com (Global directory in local languages) | IASP Crisis Centres |
Satori is completely free and open source under the Apache 2.0 licence. There are no subscriptions, no paid tiers, no cloud telemetry, and zero advertising spend.
No paid account is required to use Satori itself. While uploading a skill zip in Claude.ai or creating a saved Custom GPT in ChatGPT may require a paid plan from Anthropic or OpenAI, you can use Satori at zero cost by pasting compact/SKILL.md directly into any free web chat window, uploading to Google Gemini Gems on a standard Google account, or running Satori locally with free open-source tools (Ollama, LM Studio, Jan, OpenCode, or Hermes Agent).
In CLI and IDE harnesses, Satori's memory engine (scripts/satori_memory.py) is 100% local-first in ~/.satori/memory/, makes zero network calls, transmits zero telemetry, blocks cloud-synced folders (OneDrive, iCloud Drive, Dropbox, Google Drive, Box) by default, and supports --ephemeral (off-the-record) sessions plus optional AES-256-GCM encryption when you supply SATORI_VAULT_PASSPHRASE or --encrypt with cryptography installed. In web chat, Satori stores nothing on disk, though your chat text is processed by your chosen web provider (Anthropic, OpenAI, Google, xAI, DeepSeek, or Meta) under their respective privacy policies. See PRIVACY.md for full threat mitigations.
You can ask Satori conversationally to forget a theme, or run CLI commands directly:
python scripts/satori_memory.py statuspython scripts/satori_memory.py forget --theme "<name>"python scripts/satori_memory.py purge --all --confirm (which rewrites Markdown records, runs SQLite PRAGMA secure_delete = ON, performs WAL truncation, and executes VACUUM).For CLI and IDE installations via npx skills, remove the satori skill folder from your agent's skills directory (or delete the cloned Satori directory) and run python scripts/satori_memory.py purge --all --confirm (or delete ~/.satori/) to erase local memory. In web chat, delete the uploaded Skill, Gem, or Custom GPT in your provider assistant settings.
No. Satori works alongside therapy, not as a replacement for it. Satori is not a licensed therapist, does not diagnose mental health conditions, and is not a crisis service. It provides structured, reflective dialogue to help you clarify thoughts and patterns between human sessions. Whenever acute crisis or danger appears, Satori halts exploration and routes you to verified human crisis support.
All pull requests and local installations can be verified offline with zero API keys required:
# 1. Run static validation suite (58 checks across 20 validation sections)
python scripts/validate_skill.py
# 2. Run local memory engine self-test (8/8 unit & privacy tests)
python scripts/satori_memory.py --self-test
# 3. Run 350-case trigger boundary benchmark across all 4 strata (Full & Compact)
python scripts/run_evals.py --suite trigger --mode lint
# 4. Run pairwise LLM judge calibration check (report target: >= 0.80, floor gate: >= 0.60)
python scripts/test_judge_calibration.py
# 5. Run external Tessl skill quality review
tessl skill reviewContributions of new wisdom traditions, psychological frameworks, conversational patterns, and agent adapters are welcome. Before opening a pull request:
CONTRIBUTING.md for plain-language requirements, operational specificity, and cultural attribution standards.SECURITY.md for vulnerability disclosure guidelines.PRIVACY.md for data boundary and zero-telemetry constraints.python scripts/validate_skill.py passes all 58 automated checks with zero errors.Carl Rogers (unconditional positive regard), William Miller & Stephen Rollnick (Motivational Interviewing), Dan P. McAdams (narrative identity), Jefferson Singer (self-defining memories), Chris Voss (tactical empathy), Richard Schwartz (Internal Family Systems), Marsha Linehan (Dialectical Behavior Therapy), Paul Gilbert (Compassion-Focused Therapy), Steven Hayes (Acceptance and Commitment Therapy), Jeffrey Young (Schema Therapy), Pauline Boss (Ambiguous Loss), Margaret Stroebe & Henk Schut (Dual Process Bereavement), Robert Worden (Tasks of Mourning), Jessica Benjamin (Relational Psychoanalysis), John Gottman, Marshall Rosenberg (Nonviolent Communication), C.G. Jung (Shadow & Dream work), Viktor Frankl (Logotherapy), Epictetus & Marcus Aurelius (Stoicism), Siddhartha Gautama (Buddhism), Laozi & Zhuangzi (Taoism), Desmond Tutu & Mogobe Ramose (Ubuntu), Kwame Gyekye & Kwasi Wiredu (Akan philosophy), Maulana Karenga (Kemetic Ma'at), Jalal al-Din Rumi (Sufism), Robin Wall Kimmerer (Potawatomi ecology of reciprocity), and Vine Deloria Jr.
Satori's progressive disclosure, anti-slop voice gates, and evaluation harness were informed by open-source agent skill engineering across obra/superpowers, anthropics/skills, sickn33/antigravity-awesome-skills, blader/humanizer, kepano/obsidian-skills, AgriciDaniel/claude-obsidian, danielmiessler/fabric, ayghri/i-have-adhd, coreyhaines31/marketingskills, alirezarezvani/claude-skills, phuryn/pm-skills, deanpeters/Product-Manager-Skills, aiwithremy/claude-skills-llm-council, RinDig/icm-architect, and prompt-security/clawsec. Full license attributions are recorded in NOTICE.md.
Released under the Apache License 2.0. Formal attributions in NOTICE.md. Release history in CHANGELOG.md.
Satori: Japanese. The experience of sudden clarity. Understanding that arrives whole.