Codex / Claude / Pi

Use this path for Codex, Claude Code, Pi, and other agents that read AGENTS.md or local skills. The Enzyme skill tells your agent how to set up and use Enzyme from inside your markdown workspace.

If you are comparing runtimes, start with Supported runtimes. The short version: Codex and Claude Code have dedicated install targets, Pi uses the generic .agents path, and Hermes/OpenClaw are experimental.

Quick start

Install the CLI:

curl -fsSL enzyme.garden/install.sh | bash

Then run the install command for your agent from the vault root:

cd /path/to/your/vault

enzyme install codex      # Codex, Pi, and generic .agents readers
enzyme install claude     # Claude Code

Then ask your agent:

Set up Enzyme for this vault. First run a read-only scan, explain what is indexable or weakly indexable, then initialize and prove it with a project or meeting-prep query that cites source files.

The install command writes durable workspace instructions and a full SKILL.md for the selected runtime. The agent uses that skill to get Enzyme ready without asking you to design a memory system first.

Provider safety is part of that setup: default enzyme init and enzyme refresh use Enzyme hosted credits/auth and ignore inherited LLM env keys. Agents should not silently spend personal OpenAI/OpenRouter keys. No shell-variable cleanup is needed; use --use-env-llm only when you intentionally want your own provider.

It should preserve existing Obsidian or markdown conventions: folders, tags, wikilinks, daily notes, people pages, project notes, and frontmatter. It should not impose a hidden memory architecture.

What the skill should prove

A good first run ends with source-grounded project context, not just a green command.

Ask for something concrete:

Prep me for the next meeting on <project>. Cite the notes that show unresolved commitments, decisions, or source context.

The agent should use:

enzyme petri
enzyme catalyze "prep for next meeting on <project> unresolved commitments decisions"

A useful result names source files, quotes excerpts, and explains why those notes matter. If the result is generic, ask the agent to inspect config, exclude noisy folders, add clearer markdown handles, or run enzyme refresh after repairs.

Terminal-only fallback

If you prefer to run setup directly in a terminal:

enzyme scan --write-config
# review ~/.enzyme/config.toml
enzyme init
enzyme petri
enzyme catalyze "prep for the next meeting on <project>"

When to use it again

Use the skill when you want the agent to:

  • explain what Enzyme sees in the vault;
  • improve entity/folder selection without adding noise;
  • check whether people, projects, clients, meeting notes, or Readwise folders are being read correctly;
  • decide whether an external folder should be added with enzyme apply;
  • write compact, source-linked markdown observations that future Enzyme refreshes can retrieve.

For normal sessions, the agent can use:

enzyme refresh --quiet
enzyme petri --query "user question"
enzyme catalyze "query using petri vocabulary"

Writeback policy

Do not ask the agent to “remember everything.” A good Enzyme writeback is an ordinary markdown artifact that captures durable context:

  • decisions;
  • open loops;
  • commitments;
  • project state changes;
  • durable preferences with evidence;
  • useful people/company context with source links.

The agent should not write raw tool output, secrets, one-off commands, generic session summaries, or edits to canonical docs/roadmaps without review. See Capture memory as artifacts for the policy.

Claude Cowork

In Claude Cowork, install the Enzyme marketplace/plugin path from the setup page and use /enzyme for the guided review flow. The CLI installer does not install that app plugin; it installs the local enzyme binary and runtime instructions for local agents.