Stato

The Expertise Layer for AI Agents

Capture, validate, and transfer AI agent expertise.

What Is Stato?

Think: npm for agent expertise, with a built-in compiler.

Stato combines what pip does (install, share, registry) with what a compiler does (validate, reject invalid input) for a new kind of artifact: agent knowledge instead of code.

What no existing tool does: the agent extracts its own knowledge (crystallization), privacy scanning before export, and a composition algebra for expertise modules.

Compaction is your agent's working memory. Stato is its long-term memory — validated, on disk, portable. Where Mem0/Zep/Letta are services and skills marketplaces distribute single skills, stato distributes whole validated cognitive-state archives (context + plan + memory + skills) that any tool and any teammate can load.

Three ways stato integrates with your agent

A tool needs only one tier to work with stato; each higher tier deepens it.

Quickstart per agent

One command wires stato into your agent (it then reads the generated guidance automatically):

Deeper integration (optional): stato skill install --tool <agent> ships the "how to use stato" skill, and stato init --mcp exposes live tools like stato_workspace(task).

Starting from scratch (no .stato/ yet): pip install stato && stato init && stato crystallize, then tell your agent to "read and follow .stato/prompts/crystallize.md", then stato validate .stato/ and stato bridge --platform <agent>.

Install

pip install stato

Install from GitHub (latest development version):

pip install git+https://github.com/genecell/stato.git

Quick Start

Across Sessions (Same Project)

Your agent forgets between sessions. Stato makes its knowledge persist on disk.

# Session 1: agent captures expertise
cd my-project
stato init
stato crystallize
# Saves prompt to .stato/prompts/crystallize.md

# Ask your coding agent to capture its expertise:
#   "Read and follow .stato/prompts/crystallize.md"
# Agent writes .stato/ modules based on what it learned.

# Verify and generate bridge
stato validate .stato/
stato bridge --platform claude

# Session 2 (next day, after /compact, new terminal):
# CLAUDE.md and .stato/ files are still on disk.
# Agent reads CLAUDE.md automatically.
stato resume             # structured recap if needed

No export. No import. Files on disk persist across every session.

Across Projects and People

Transfer expertise to a new project, a teammate, or the community.

# Export
stato snapshot --name scrna-expert --sanitize

# Import into new project
cd ~/new-project && stato init
stato import scrna-expert.stato

# Or install from the community registry
stato registry install genecell/scrna-expert

Composition algebra for working with expertise archives:

Across Platforms

Same expertise, different coding agents. One command generates every bridge:

stato bridge --platform all

# Creates the file each tool reads automatically:
#   AGENTS.md                           -> Codex, and most agents (cross-tool standard)
#   CLAUDE.md                           -> Claude Code
#   .cursor/rules/stato.mdc             -> Cursor
#   .github/copilot-instructions.md     -> GitHub Copilot
#   GEMINI.md                           -> Gemini CLI
#   README.stato.md                     -> anything else / humans

From Web AI to Coding Agent

Plan architecture in Claude.ai or ChatGPT. Build in any coding agent.

stato crystallize --web
# Paste prompt into web AI -> get bundle -> save as stato_bundle.py
stato import-bundle stato_bundle.py
stato bridge --platform cursor

Why Stato Exists

AI coding agents are powerful but stateless. Every session starts from zero. Expertise earned in one session, one project, or one platform stays trapped there.

Stato treats agent expertise like code: captured in structured modules, validated by a 7-pass compiler, composed with algebraic operations, and portable across any platform. Your agent's knowledge becomes a permanent, shareable, validated artifact.

Read the full story ->

Features

CLI Reference

Full documentation: stato.hiniki.com | USAGE.md

Comparison

Registry

Browse and install shared expertise packages:

stato registry list
stato registry search "bioinformatics"
stato registry install scrna-expert

Contributing

https://github.com/genecell/stato

Issues and PRs welcome.

Contact

Min Dai - dai@broadinstitute.org

Fishell Laboratory, Harvard Medical School and the Broad Institute of MIT and Harvard.

License

MIT