{"slug": "show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents", "title": "Show HN: Enzyme – a programming language that compiles wikis for agents", "summary": "A developer released Enzyme, an open-source programming language that compiles a Markdown notes folder into a local search index for coding agents such as Claude Code and Codex, letting them retrieve and cite related notes written over months. Enzyme installs via a curl script from its GitHub repository (byenzyme/enzyme) and an agent-specific command (`enzyme install claude`, or codex, hermes, openclaw), then reads an editable `.enzyme` settings file specifying which folders, tags and links to index. The tool generates \"catalysts\" — questions sampled from excerpts across time — via `enzyme petri` and ranks notes by wording and meaning together via `enzyme catalyze`, with search running entirely on the user's machine.", "body_md": "Enzyme helps your coding agent work from your notes. It reads how your Markdown notes are already organized (folders, tags, links, and dates) and builds a local index, so Claude Code or Codex can pull up related notes from months of writing and cite them.\n\nOpen your Markdown notes folder in Claude Code, Codex, or another agent that can run terminal commands, and paste this prompt. If your agent is open elsewhere, give it the path to your notes.\n\n```\nSet up Enzyme for the Markdown notes folder I have open. If you cannot identify it, ask me for its path.\n\nInstall Enzyme if needed using https://raw.githubusercontent.com/byenzyme/enzyme/main/install.sh, and install the instructions for this agent. Read and follow the installed enzyme-workspace-setup skill.\n\nYou may use Enzyme's online service to suggest settings from my notes and prepare search. Show me what you propose to include or exclude, and let me correct it before building the local search index.\n\nThen answer one useful question using my notes, with links to the sources, and suggest a question I can ask next. Keep my existing notes in place and unchanged. Ask separately before any cleanup, model download, or recurring task.\n```\n\nYour agent installs Enzyme and follows its setup skill. It proposes which folders, tags, and links to read, shows you the settings so you can correct them, builds the index, and answers one real question with links to the notes behind it. Your notes stay where they are, and you don't need to clean them up first.\n\nAfter setup, keep working with your agent as usual. The installed skill tells it\nwhen to search with Enzyme, when plain search is better, and when to run\n`enzyme refresh` so new notes are included.\n\nPrefer to install it yourself first? Run this, then paste the same prompt:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/byenzyme/enzyme/main/install.sh | bash\ncd /path/to/your/notes\nenzyme install claude # or: codex, hermes, openclaw\n```\n\nEnzyme was built for knowledge bases that grow quickly:\n\n- Obsidian vaults that accumulate dated notes in a few folders\n- Meeting notes and AI-native, Markdown CRM setups\n- Agent memory written as Markdown\n\nIt helps most when a question spans many notes written over time: what changed in a project, what keeps coming up with a person, why a decision went the way it did. For a name, title, or exact phrase, plain search is faster, and the installed skill tells your agent to use it.\n\nSetup saves a short, editable settings file (an `.enzyme` program) that says\nwhat to read. When the index is built, Enzyme does two things:\n\n1. **Maps what matters.** It samples excerpts across time from each folder,\ntag, or link you chose and writes questions from them, called**catalysts** , about what you decided, changed, or left open there.`enzyme petri` shows this map.\n2. **Indexes every note for search.**`enzyme catalyze` ranks notes by wording\nand meaning together, so a search finds the passage whether your agent names\nsomething exactly or only describes it. Each result carries the catalyst that\nbest connects it to the query. Search runs entirely on your machine.\n\nYour agent orients on the map, searches from several angles, and answers from your own passages, so it can tell you how your thinking moved, not just what one note says. Catalysts are generated, so they're hints, never evidence: judge setup by the notes your agent brings back.\n\nA small settings file looks like this. Your agent writes and edits it with you during setup:\n\n```\nworkspace \"notes\" {\n  source markdown \"notes\" { path \"~/notes\" }\n\n  learn questions from folder \"people\" including linked pages about relational\n  learn questions from folder \"meetings\" about operational\n  learn questions from tags [\"startup\", \"design\"] about decision_trace\n}\n```\n\nEach reading uses a profile that sets what to look for. The built-in profiles\nwere refined over [2 years of personal use](https://joshpham.com/kit/how-i-use-enzyme):\n\n| Read... | For... | Profile | \n|---|---|---|\n| Project notes | what's stuck and what keeps blocking | `operational` | \n| Decision records | why a choice won, what would change it | `decision_trace` | \n| Saved articles | connections to what you're already working on | `resonance_trace` | \n| Journals | what keeps returning across entries | `reflective` | \n| People notes | what matters in these relationships | `relational` | \n| Feedback / activity logs | what works for you, under what constraints | `preference_evidence` | \n| *(default)* | costs, assumptions, live tensions | `tension_trace` | \n\n```\nenzyme compile -v\n# Review the .enzyme settings file at the path printed by compile.\nenzyme init --quiet\nenzyme doctor\nenzyme catalyze \"a question about your notes\"\n```\n\n`compile` proposes settings and saves them; `init` builds the local index from\nthem; `doctor` reports what was indexed and any problems.\n\nFor Apple Notes, a preset builds a named `workspace` program from your Notes\ndatabase. Review the saved `.enzyme` program before running `init`:\n\n```\nenzyme --workspace apple-notes compile --preset apple-notes \\\n  \"$HOME/Library/Group Containers/group.com.apple.notes/NoteStore.sqlite\"\nenzyme --workspace apple-notes init\n```\n\nFor Are.na, use `enzyme --workspace <name> compile --preset arena <channel-url>`\nand then `enzyme --workspace <name> init`. Run `refresh` with the\nsame `--workspace` name to pick up later changes (`--collection` is an accepted\nalias).\n\n`enzyme petri` shows what Enzyme found worth asking about: for each recurring tag, link, or folder, questions about what you decided, changed, or left open, sampled across time. In a terminal it renders a tree; piped, it emits JSON.\n\n```\nenzyme petri -n 2\nPetri\n├─ #working-with-others · tag · active · 11 mentions\n│  └─ catalysts\n│     ├─ Why did every auth change still route through me after I kept promising to write it down?\n│     ├─ Why did the third auth extraction attempt stall when nobody wanted to own the session model?\n│     ├─ Which reasons for handing the session model to Maya had I stopped believing by then?\n│     ├─ Did extraction stay paused once Maya's team owned the session model?\n│     └─ …\n└─ #system-design · tag · active · 10 mentions\n   └─ catalysts\n      ├─ Why did I pick a monolith with inner module boundaries over splitting services yet?\n      ├─ Did I ever settle who owns the session model once auth moves out?\n      ├─ Which part of auth extraction kept adding layers instead of removing one?\n      ├─ Does my view that independence means who can change what still hold?\n      └─ …\n```\n\nAn agent reads this map first, then searches. `enzyme catalyze` ranks notes by wording and meaning together, and each result carries the catalyst that best connects it to the query:\n\n```\nenzyme catalyze -n 3 \"why we keep rewriting the auth layer\" \\\n  | jq '{search_strategy, results: [.results[] | {file_path, similarity, via_catalyst_text, content}]}'\n{\n  \"search_strategy\": \"hybrid\",\n  \"results\": [\n    {\n      \"file_path\": \"retros/2025-q3-platform-retro.md\",\n      \"similarity\": 0.817,\n      \"via_catalyst_text\": \"Why did I keep scoping auth extraction as a two-week project, and what kept stalling it?\",\n      \"content\": \"# Q3 platform retro\\n#system-design #working-with-others\\n\\nScoped auth extraction as a two-week project for the third time. The real blocker was not the token service; nobody wanted to own the session model. Every proposal added a layer instead of removing one. Action: decide ownership before touching code again.\"\n    },\n    {\n      \"file_path\": \"journal/2025-05-12.md\",\n      \"similarity\": 0.693,\n      \"via_catalyst_text\": \"Why did every auth change still route through me after I kept promising to write it down?\",\n      \"content\": \"#working-with-others\\n\\nReviewed eleven PRs today and wrote none. Every auth change still routes through me because I wrote the session code and nobody else wants to touch it. I keep saying I will write it down so someone else can own it. I have not.\"\n    },\n    {\n      \"file_path\": \"1on1s/2026-01-maya.md\",\n      \"similarity\": 0.579,\n      \"via_catalyst_text\": \"What keeps pulling me back to rewriting when Maya's smaller version already worked?\",\n      \"content\": \"# 1:1 with Maya\\n#working-with-others\\n\\nMaya replaced the token refresh path with something half the size of mine. She asked me twice and then stopped asking, which is the point. I want to do this with billing before I start rewriting it myself.\"\n    }\n  ]\n}\n```\n\n*Captured from a 17-note example vault of a team lead's ADRs, retros, 1:1s, and journal. Catalyst wording comes from model generation, so it varies between runs.*\n\nScripts and host apps can rely on defined exit codes (0 ok, 1 runtime failure,\n2 usage, 3 configuration, 4 workspace busy, 5 `init` indexed but catalysts\nfailed their quality gate). Concurrent `init`/` refresh` calls\non one workspace wait for each other, bounded by `--lock-timeout`.\n\nEnzyme indexes SQLite tables alongside Markdown — iMessage, WhatsApp, Mail, or any table of dated rows.\n\nDeclare a `source sqlite` inside a named `workspace` program, then run `init`\nand periodic `refresh`. The [SQLite source setup skill](https://github.com/byenzyme/enzyme/blob/main/skills/enzyme-sqlite-source/SKILL.md)\nshows the source declaration and source-scoped readings.\n\nNone of these is a special case. A `handle_id` column is repeated person values across dated rows, the same way `[[links]]` are repeated person values across dated notes. Both collapse to entity occurrences with effective dates, and nothing downstream knows which one it came from: the same profiles, budgets, and catalysts apply to a message thread and a folder of meeting notes.\n\nA source names columns by the role they play rather than by the app they came from:\n\n| Role | Means | \n|---|---|\n| `id` | the row's identity | \n| `who` | participants; scalar, JSON array, or delimited | \n| `when` | the row's timestamp | \n| `what` | the text to read | \n| `where` | the container the row belongs to (optional) | \n| `weight` | numeric significance per occurrence (optional) | \n\nEnzyme needs an API key only for catalyst generation and for Markdown `enzyme compile`'s selection step. Source preset compilation does not call a model. By default `enzyme init` uses Enzyme's hosted bootstrap and ignores inherited `OPENAI_*` variables so it does not spend your personal key. Credential resolution is explicit key → configured local model → anonymous brokered free config, with no additional configuration.\n\nThe first configured vault on a machine initializes without login. Refresh, publishing, account credits, and additional vaults require `enzyme login`.\n\nTo bring your own OpenAI-compatible key, pass `--llm env` (alias `--use-env-llm`), which reads only `OPENAI_API_KEY` plus optional `OPENAI_BASE_URL` and `OPENAI_MODEL`. `init` and `refresh` also take `--llm local` (the installed local model; fails if none is installed), `--llm hosted`, and `--llm none` (index, embed, and select without generating catalysts). Without `--llm` and without any hosted or env key, catalyst generation is skipped and indexing, embedding, and local search still work.\n\nMarkdown `enzyme compile` is an explicit OpenRouter Decisions operation. It reuses the hosted lease from `enzyme login` and the free-config broker; an explicit `OPENAI_API_KEY` with `OPENAI_BASE_URL=https://openrouter.ai/api/v1` takes precedence. Catalyst generation uses `OPENAI_MODEL`; Decisions uses `ENZYME_JEV_MODEL` (default `typesafe/jev-1.13`).", "url": "https://wpnews.pro/news/show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents", "canonical_source": "https://github.com/byenzyme/enzyme", "published_at": "2026-10-24 13:30:18+00:00", "updated_at": "2026-10-24 13:41:15.505292+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Enzyme", "Claude Code", "Codex", "Obsidian", "byenzyme", "Josh Pham"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents", "markdown": "https://wpnews.pro/news/show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents.md", "text": "https://wpnews.pro/news/show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents.txt", "jsonld": "https://wpnews.pro/news/show-hn-enzyme-a-programming-language-that-compiles-wikis-for-agents.jsonld"}}