Satori — AI skill for Claude Code
Self-learning loop for Claude Code — corrections and failures become skills, behind a human gate.
How to install Satori
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open timoncool/satori and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Satori does
Self-learning loop for Claude Code — corrections and failures become skills, behind a human gate. MCP + hooks, Windows-native, zero background LLM calls.
Alternatives in AI
- Omnara — by Ishaan Sehgal - A command center for AI agents that syncs Claude Code sessions across terminal, web, and mo 2.6k ★
- Agentrq — AgentRQ: Human-in-loop realtime conversational task manager for AI Agents 1.1k ★
- Metaharness — 🛠️ The meta-harness for AI agents — scaffold your own focused, branded agent harness with its own npx CLI, MC 616 ★
README
satori
**A self-learning loop for Claude Code — the model learns skills from its own sessions. Fully automatic, fully visible, fully reversible.**
[](#-beta-disclaimer) [](LICENSE) [](https://github.com/timoncool/satori/stargazers) [](https://github.com/timoncool/satori/commits)
**[English](README.md)** · **[Русский](README_RU.md)**

⚠️ Beta disclaimer
This is **beta software** I build for myself and share with the community as-is. It parses your session transcripts, stores lesson data locally and — **by default, automatically** — activates skills that will instruct your future Claude sessions. Every activation is announced in chat (⛩) and reversible in one call (`retire_skill`), but do read `server.py` and watch what your agent learns. It works on my setup; I can't guarantee yours and **take no responsibility** for the skills your agent teaches itself. Want to pre-approve everything instead? `SATORI_AUTO_APPROVE=0`.
satori is an MCP server + hooks that give Claude Code a closed self-learning loop: user corrections and tool failures become lesson candidates, lessons become skill drafts, drafts become active skills — automatically, visibly, reversibly. Windows-native, works in Claude Desktop, zero bash wrappers.
Two principles you won't find together elsewhere: **the server does only deterministic mechanics** (parsing, counters, storage, validation) — the thinking is done by the calling model right in the session, no background LLM calls, no extra bills; and **fully automatic, fully visible, fully reversible** — validated drafts activate on their own, every lo
Related Skills
Agentic Review Gate
Governed, auditable AI review platform: the review and approval work a team does by hand, as a webhook-trigger
Ethos Gate
A PreToolUse safety gate for autonomous AI agents: blocks irreversible or outward-facing actions (sends, spend
Claude Code Trace Visualizer
Trace and visualize what Claude Code does during a run: tool calls, timing, file access, retries/failures, and
AI Skillweave
Auto-learning agent harness: captures corrections live, mines session history for patterns, syncs ~2500 skills
Yotta Mirror
Deterministic, local learning-diagnostics skill for AI agents: score sheets plus an item-to-knowledge map beco
Model Specs
Community catalog of LLM model specs — pricing, context windows, capabilities, and AI-CLI compatibility. Auto-
Related Agents
Mod Builder
Creates and changes Claude Code mods — plugins of function hooks behind a pane, band, status line, slash comma
Askit Quality Grader
Judges whether a skill triggers and behaves correctly by running it against its eval-set and grading the outpu
Continuous Claude V2
Context management for Claude Code. Hooks maintain state via ledgers and handoffs. MCP execution without conte