# Autograph > Typed memory layer for always-on agents (Claude Code, OpenClaw, Hermes, Codex). Schema-as-code for any Obsidian vault: decay engine, health scoring, link repair, MOC generation. - **Type:** MCP server - **Install:** `agentstack add mcp-smixs-autograph` - **Verified:** Yes β€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [smixs](https://agentstack.voostack.com/s/smixs) - **Installs:** 0 - **Category:** [Productivity](https://agentstack.voostack.com/c/productivity) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [smixs](https://github.com/smixs) - **Source:** https://github.com/smixs/autograph ## Install ```sh agentstack add mcp-smixs-autograph ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 🧠 autograph **A typed memory layer for always-on agents. One schema, one graph, any Obsidian vault.** [](https://github.com/smixs/autograph/releases) [](https://www.python.org) [](https://github.com/smixs/autograph) [](./LICENSE) **πŸ‡¬πŸ‡§ English** Β· [πŸ‡·πŸ‡Ί Русский](./README.ru.md) --- 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](#-install) - [πŸš€ Quickstart](#-quickstart) - [πŸ’‘ Use cases](#-use-cases) - [⏰ Scheduling](#-scheduling) - [🧬 How decay works](#-how-decay-works) - [πŸ“¦ What's inside](#-whats-inside) - [πŸ”— Lineage](#-lineage) ## ⚑ 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 ```bash 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 `/.agents/skills/autograph/`. Hermes (NousResearch) β€” github source ```bash 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 ```bash 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 ```bash # 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 | Scenario | Commands | Why | |---|---|---| | **Audit someone else's vault** | `discover.py` β†’ `graph.py health` β†’ `graph.py fix --apply` | Understand state before changing anything | | **Bootstrap empty or chaotic vault** | `/autograph:research ` | Interactive Q&A + explorer agent swarm β†’ schema draft β†’ approval | | **Create a card with guaranteed links** | Workflow 3 in SKILL.md: type β†’ path β†’ frontmatter β†’ `## Related` (hub + 2 siblings) β†’ `engine.py touch` | Orphan cards are dead knowledge β€” the skill won't close the task until links are in place | | **Import from CRM / external source** | `engine.py init` β†’ `enforce.py --apply` β†’ `enrich.py tags --apply` β†’ `enrich.py swarm-links --apply` | Exports from HubSpot / Notion / OneNote / Apple Notes become indistinguishable from hand-written cards | | **Spaced repetition of forgotten knowledge** | `engine.py creative 5 ` + cron | The 5 oldest cards surface back in `warm` tier for review | ## ⏰ Scheduling Decay + health at night. Dedup + MOC on Sundays. OpenClaw cron ```bash openclaw cron add --name "autograph-daily" \ --cron "0 3 * * *" --tz "Europe/Amsterdam" \ --session isolated --tools exec,read \ --message "uv run ~/.openclaw/skills/autograph/scripts/engine.py decay /path/to/vault && uv run ~/.openclaw/skills/autograph/scripts/graph.py health /path/to/vault" openclaw cron add --name "autograph-weekly" \ --cron "0 4 * * 0" --tz "Europe/Amsterdam" \ --session isolated --tools exec,read \ --message "uv run ~/.openclaw/skills/autograph/scripts/dedup.py /path/to/vault --apply && uv run ~/.openclaw/skills/autograph/scripts/moc.py generate /path/to/vault" ``` Hermes cron ```bash hermes cron create "0 3 * * *" "autograph decay + health on /path/to/vault" --skill autograph hermes cron create "0 4 * * 0" "autograph dedup + MOC on /path/to/vault" --skill autograph ``` Job output: `~/.hermes/cron/output/{job_id}/{ts}.md`. System cron ```cron 0 3 * * * cd /path/to/vault && uv run ~/dev/autograph/skills/autograph/scripts/engine.py decay . >/tmp/autograph-decay.log 2>&1 5 3 * * * cd /path/to/vault && uv run ~/dev/autograph/skills/autograph/scripts/graph.py health . >/tmp/autograph-health.log 2>&1 0 4 * * 0 cd /path/to/vault && uv run ~/dev/autograph/skills/autograph/scripts/moc.py generate . >/tmp/autograph-moc.log 2>&1 ``` **Targets:** health β‰₯ 90, broken_links = 0, description coverage β‰₯ 80%, stale (>90d) 1. Access count (spacing effect) Each `touch` increments `access_count`. More retrievals slow forgetting: ``` strength = 1 + ln(access_count) effective_rate = base_rate / strength relevance = max(floor, 1.0 βˆ’ effective_rate Γ— days_since_access) ``` A card touched 5 times decays ~2.6Γ— slower than one touched once. 2. Domain-specific rates | Type | Rate | Half-life | Rationale | |---|---|---|---| | `contact` | 0.005 | ~100 days | People don't go stale quickly | | `crm` | 0.008 | ~62 days | Deals have medium lifecycle | | `learning` | 0.010 | ~50 days | Knowledge fades moderately | | `project` | 0.012 | ~42 days | Projects have deadlines | | `daily` | 0.020 | ~25 days | Daily notes lose relevance fast | | default | 0.015 | ~33 days | Fallback for everything else | 3. Graduated recall A touch promotes one tier at a time: `archive β†’ cold β†’ warm β†’ active`. `last_accessed` is set to the midpoint of the interval β€” so without a re-touch the card naturally drifts back down. ## πŸ“¦ What's inside ``` autograph/ β”œβ”€β”€ .claude-plugin/ β”‚ β”œβ”€β”€ plugin.json # Manifest (Claude Code, OpenClaw) β”‚ └── marketplace.json # Marketplace entry β”œβ”€β”€ commands/research.md # /autograph:research slash command β”œβ”€β”€ skills/autograph/ β”‚ β”œβ”€β”€ SKILL.md # Skill instructions for the model β”‚ β”œβ”€β”€ schema.example.json # Generic starting template β”‚ β”œβ”€β”€ references/ # Bootstrap workflow, card templates, schema docs β”‚ β”œβ”€β”€ scripts/ # 14 engine scripts (stdlib only) β”‚ β”œβ”€β”€ tests/ # 220 self-contained tests β”‚ └── evals/evals.json # Skill-creator eval cases └── LICENSE ``` Engine scripts β€” 14 total | Script | Purpose | |---|---| | `common.py` | FM parser, walk, domain inference, decay formula | | `discover.py` | Phase 1: scan vault, enum candidates | | `generate_schema.py` | Phase 2A: discovery β†’ draft schema | | `swarm_prepare.py` | Phase 2B: bin-pack vault into agent batches | | `swarm_reduce.py` | Phase 2B: consolidate + validate schema | | `research.py` | `/research` helper: gate + manifests + reduce | | `enforce.py` | Phase 4: validate + auto-fix against schema | | `link_cleanup.py` | Phase 5: remove phantom wikilinks | | `enrich.py` | Phase 6/8: tags + catalog-based swarm-links via LLM | | `dedup.py` | Phase 7: safe merge + `.trash/` | | `graph.py` | Health score, repair, backlinks, orphans | | `moc.py` | Map-of-Content generation | | `engine.py` | Decay, touch, creative recall, stats, init | | `daily.py` | Entity extraction from daily/memory files | **Requirements:** Python 3.11+, [`uv`](https://github.com/astral-sh/uv), Obsidian-style vault (folder of `.md` with YAML frontmatter). Optional: `OPENROUTER_API_KEY` for enrich.py. No `pip install` needed β€” stdlib only. **Tests:** ```bash cd skills/autograph && uv run tests/test_autograph.py ``` ## πŸ”— Lineage Grew out of [`smixs/agent-second-brain`](https://github.com/smixs/agent-second-brain) β€” a Telegram-first "second brain" bot that classified voice transcripts into an Obsidian vault with a 9pm daily report. The decay engine, vault-health scoring, and graph tools turned out to be the part every agent needed, not just that one bot. `autograph` extracts them into a shared memory layer for any runtime. --- Made with care in Tashkent Β· [MIT License](./LICENSE) Β· [Issues](https://github.com/smixs/autograph/issues) ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source β€” we do not rehost the code. - **Author:** [smixs](https://github.com/smixs) - **Source:** [smixs/autograph](https://github.com/smixs/autograph) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** β€” Free ## Security capabilities Automated source analysis of v0.1.0 β€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source β€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** β€” security scan: passed β€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-smixs-autograph - Seller: https://agentstack.voostack.com/s/smixs - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack β€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.