Welcome
The home for everything you tell your AI — a local, file-based library of reusable prompts, agents, commands, and skills.
yori gives all the words you tell your AI a single place to live: a local,
file-based library of reusable AI building blocks — prompts, agents,
slash-commands, skills, and rules — that you can list, edit,
compose, and render into ready-to-pipe text.
It's a pure renderer: text in, text out. yori never calls a model. You own
the model invocation — pipe the rendered prompt into claude, llm, or
anything else.
cat bug.log | yori run triage --tone=blunt | claudeNamed after Tron's Yori, who ran the I/O Tower — the gateway where a User's words reached their program.
Why?
Right now your prompts live everywhere and nowhere — half-buried in code, pasted into a dozen chat windows, screenshotted in a Slack thread, slightly reworded by every person on the team. Nobody's sure which version is the good one. yori gives them one home.
Highlights
| 📄 Plain files | Every artifact is a markdown file with YAML frontmatter. Greppable, $EDITOR-friendly, diffs cleanly, versioned with your own git. |
| 🧩 Unified artifacts | One home for prompts, agents, slash-commands, skills, and rules — same treatment, organized by type. |
| 🪢 Composition | Liquid templating: {{ variables }}, {% include %} partials, {% if %}/{% for %}, and template inheritance via slots. |
| 🚰 Pipe-first | Reads stdin, writes stdout. {{ input }} captures piped text (or it's appended). Drops into any Unix pipeline. |
| 🗂️ Layered store | A project ./.yori shadows your global ~/.yori, which is backed by installed packages — like a search path for prompts. |
| 📦 Git-as-registry | yori install <git-url> to pull a team's shelf; yori push to publish yours. No server — git is the transport. |
| 🔌 Deploy to agents | yori sync renders skills, commands, and subagents into the dirs Claude Code, Codex, and Cursor discover them from. |
| 🧪 Eval via promptfoo | yori export promptfoo turns a composed artifact + its cases into a promptfooconfig.yaml. |
| 🚫 No model, no telemetry | Pure text transform. The only network use is git, when you ask for it. |
Where to next
- Getting Started — install, init, and run the core loop in under a minute.
- Concepts — artifacts, the four types, and the layered store.
- Templating — variables, partials, logic, and inheritance.
- Registry — share and install over git.
- Deploy to agents —
yori syncinto Claude Code, Codex, Cursor. - Command reference — every subcommand and flag.