An always-on agent writes notes into your Obsidian vault every day — voice transcripts, meetings, ideas, contacts. A month later you have 800 files, broken wiki-links, duplicates, and no one remembers whether status: ongoing is the same as status: active. autograph is the layer that keeps all of that in order automatically.
You describe the taxonomy once in schema.json: what card types exist (note, contact, project, CRM deal), which folder holds which domain, how fast each kind of knowledge decays, which statuses are allowed. From there the engine takes over — it places new files, repairs links, forgets cards you haven't touched for months, merges duplicates, computes a health score. One schema.json is read by Claude Code, OpenClaw, Hermes, Codex — any agent writing to your vault.
📋 Table of contents
⚡ Install
Claude Code — marketplace or direct
/plugin marketplace add smixs/autograph
/plugin install autograph@autograph
Direct install without registering the marketplace:
/plugin install github:smixs/autograph
Update / uninstall:
/plugin marketplace update autograph
/plugin uninstall autograph
OpenClaw — via .claude-plugin/plugin.json bundle autodetect
git clone https://github.com/smixs/autograph.git ~/dev/autograph
openclaw plugins install ~/dev/autograph
openclaw gateway restart
The skill lands in ~/.openclaw/skills/autograph/ and /autograph:research becomes available globally. For one workspace only, clone into <workspace>/.agents/skills/autograph/.
Hermes (NousResearch) — github source
hermes skills install github:smixs/autograph/skills/autograph
The skill lands in ~/.hermes/skills/autograph/. Hermes doesn't support Claude Code slash-commands — commands/research.md is ignored, but the whole workflow lives in the skill, so just invoke the skill by name in chat.
Moving from OpenClaw to Hermes? hermes claw migrate imports autograph to ~/.hermes/skills/openclaw-imports/.
Codex — via symlink
git clone https://github.com/smixs/autograph.git ~/dev/autograph
ln -s ~/dev/autograph/.claude-plugin ~/dev/autograph/.codex-plugin
Point Codex at ~/dev/autograph in your agents config.
🚀 Quickstart
# 1. Point at a vault — empty, chaotic, or already populated
/autograph:research /path/to/vault
# 2. Daily health check
uv run skills/autograph/scripts/graph.py health /path/to/vault
# 3. Decay pass: recompute relevance + tier for every card
uv run skills/autograph/scripts/engine.py decay /path/to/vault
# 4. Regenerate Map-of-Content indexes
uv run skills/autograph/scripts/moc.py generate /path/to/vault
The 10-phase bootstrap (discover → generate → swarm → enforce → cleanup → tag → dedup → link → MOC → verify) is in skills/autograph/references/bootstrap-workflow.md.
💡 Use cases
