Andreas Heige

· 4 min · information engineering, small models

How Autograph turns your work into a vault

Contents · 6 sections

Autograph collects what you do in coding agents (Claude Code, Codex, Copilot CLI, Pi), in Claude Desktop and in git, and writes it as linked notes in one Obsidian vault. This describes how it works as of 24 October 2026: who writes what, when it runs, and what you still decide by hand.

Summaries are written by a local model (Ollama). Session records and captures stay on the Mac; only the vault’s Markdown is pushed to its git remote.

The whole flow

Read left to right. Solid arrows move data; dotted arrows are lookups.

  1. Claude Code
  2. Codex CLI
  3. Copilot CLI · Pi
  4. Claude Desktop you say: autograph this
  5. Git repos
  6. ~/.claude · ~/.codex ~/.copilot · ~/.pi
  7. ~/.autograph/ desktop-captures
  8. Session observer always on
  9. Read last 7 days of records + commits
  10. Group into work units by project and session
  11. Ollama, locally: one section per unit + a day summary
  12. Tag from vocabulary.md link related wiki pages
  13. Write notes, rebuild agent indexes
  14. Vault cleanup Mon 09:00
  15. daily_notes/
  16. projects/ + commits/
  17. sessions/ · agents/
  18. wiki/ own local git repo
  19. vocabulary.md you curate
  20. Wiki jobs dream 07:00 · ingest 12:30 lint Mon 12:00
  21. Obsidian graph + Bases
  22. Vault git remote
  1. Claude Desktop you say: autograph this leads to ~/.autograph/ desktop-captures: capture tool
  2. Git repos leads to Session observer always on: new commit
  3. Session observer always on leads to projects/ + commits/: session context
  4. Claude Desktop you say: autograph this leads to sessions/ · agents/: full note
  5. Vault cleanup Mon 09:00 leads to Vault · ~/.autograph/vault: removes only files with no value (lookups)
  6. Vault · ~/.autograph/vault leads to Vault git remote: commit + push .md
  • Claude Code leads to ~/.claude · ~/.codex ~/.copilot · ~/.pi
  • Codex CLI leads to ~/.claude · ~/.codex ~/.copilot · ~/.pi
  • Copilot CLI · Pi leads to ~/.claude · ~/.codex ~/.copilot · ~/.pi
  • ~/.claude · ~/.codex ~/.copilot · ~/.pi leads to Session observer always on
  • Read last 7 days of records + commits leads to Group into work units by project and session
  • Group into work units by project and session leads to Ollama, locally: one section per unit + a day summary
  • Ollama, locally: one section per unit + a day summary leads to Tag from vocabulary.md link related wiki pages
  • Tag from vocabulary.md link related wiki pages leads to Write notes, rebuild agent indexes
  • ~/.claude · ~/.codex ~/.copilot · ~/.pi leads to Read last 7 days of records + commits
  • ~/.autograph/ desktop-captures leads to Read last 7 days of records + commits
  • Git repos leads to Read last 7 days of records + commits
  • Write notes, rebuild agent indexes leads to daily_notes/
  • Write notes, rebuild agent indexes leads to projects/ + commits/
  • Write notes, rebuild agent indexes leads to sessions/ · agents/
  • vocabulary.md you curate leads to Tag from vocabulary.md link related wiki pages (lookups)
  • wiki/ own local git repo leads to Tag from vocabulary.md link related wiki pages (lookups)
  • Wiki jobs dream 07:00 · ingest 12:30 lint Mon 12:00 leads to wiki/ own local git repo
  • vocabulary.md you curate leads to Wiki jobs dream 07:00 · ingest 12:30 lint Mon 12:00 (lookups)
  • Vault · ~/.autograph/vault leads to Obsidian graph + Bases
  • Where you work
    • Claude Code
    • Codex CLI
    • Copilot CLI · Pi
    • Claude Desktop you say: autograph this
    • Git repos
  • Raw records on the Mac
    • ~/.claude · ~/.codex ~/.copilot · ~/.pi
    • ~/.autograph/ desktop-captures
  • Daily notes job · 08:00
    • Read last 7 days of records + commits
    • Group into work units by project and session
    • Ollama, locally: one section per unit + a day summary
    • Tag from vocabulary.md link related wiki pages
    • Write notes, rebuild agent indexes
  • Vault · ~/.autograph/vault
    • daily_notes/
    • projects/ + commits/
    • sessions/ · agents/
    • wiki/ own local git repo
    • vocabulary.md you curate
Fig. 1 — The whole flow

Inside the 08:00 job

What run_daily_backfill.py does, in order:

  1. Collect. Reads every agent’s session files, saved Claude Desktop chats and git commits from the last 7 days.
  2. Clean. Drops tool and system messages, duplicates and empty lines. Finds each record’s project from the folder it ran in.
  3. Group. Splits the work into units per project and session, cutting long sessions at idle gaps.
  4. Skip what’s current. A fingerprint per day means an unchanged day is left alone and costs no Ollama calls.
  5. Write with Ollama. One local model call per unit gives what was done, what went well and what was learned, then one call writes the day summary.
  6. Tag and link. Matches each section against the ticked terms in vocabulary.md, then links up to 3 wiki pages that share at least 2 of those terms.
  7. Write notes. A daily note with frontmatter, plus commit, session, project and agent notes.
  8. Sync. Commits the changed Markdown in the vault and pushes it to the vault’s git remote.

The vocabulary loop: machines propose, you decide

Nothing becomes a tag until you tick it in vocabulary.md. Ticking or retiring a term changes daily notes the next time they’re written or retrofitted.

  1. Claude Desktop capture suggests tags
  2. note tags
  3. proposed_tags, plus an unticked line in vocabulary.md
  4. You tick it, retire it, or leave it
  5. vocabulary.md 276 terms, from SWEBOK, NIST SSDF, OWASP, DORA, MCP
  6. run_daily_note_retrofit.py refresh old notes, no Ollama
  7. Daily notes tags + Related wiki
  8. wiki-lint, Mondays flags off-vocabulary tags
  9. wiki-ingest fixes those pages
  1. Claude Desktop capture suggests tags leads to note tags: known term
  2. Claude Desktop capture suggests tags leads to proposed_tags, plus an unticked line in vocabulary.md: new label
  • proposed_tags, plus an unticked line in vocabulary.md leads to You tick it, retire it, or leave it
  • You tick it, retire it, or leave it leads to vocabulary.md 276 terms, from SWEBOK, NIST SSDF, OWASP, DORA, MCP
  • vocabulary.md 276 terms, from SWEBOK, NIST SSDF, OWASP, DORA, MCP leads to Daily notes tags + Related wiki
  • vocabulary.md 276 terms, from SWEBOK, NIST SSDF, OWASP, DORA, MCP leads to wiki-lint, Mondays flags off-vocabulary tags
  • wiki-lint, Mondays flags off-vocabulary tags leads to wiki-ingest fixes those pages
  • wiki-ingest fixes those pages leads to Daily notes tags + Related wiki
  • run_daily_note_retrofit.py refresh old notes, no Ollama leads to Daily notes tags + Related wiki
Fig. 2 — The vocabulary loop: machines propose, you decide

What runs on its own

These are macOS launchd jobs. If the Mac is asleep or off, a missed job runs once when it wakes.

WhenJobWhat it does
At loginSession observerWatches agent sessions; on each new commit, adds the session context to that commit’s note.
Daily 07:00wiki-dreamApplies the facts reviewed the day before (a correction rewrites the old fact in place), then proposes new memory facts from session dialogue and has a second model review them.
Daily 08:00Daily notesThe 8 steps above, for the last 7 days.
Mon 09:00Vault cleanupRemoves empty placeholders, redundant legacy notes and empty folders. Never anything with content of its own.
Mon 12:00wiki-lintChecks wiki pages, including tags against vocabulary.md.
Daily 12:30wiki-ingestBrings new and changed plans, memory and repo docs into wiki/.

Commands you run yourself

CommandWhen to use it
run_daily_note_retrofit.pyAfter ticking or retiring vocabulary terms: refreshes tags and wiki links on every daily note, without Ollama.
run_vault_cleanup.py --dry-runSee what the Monday cleanup would remove, and why.
run_daily_backfill.py --days 14 --replace-generatedRewrite generated notes from scratch. One Ollama call per work unit, and it pushes the vault.
“autograph this” in Claude DesktopSave the current chat as a note. Unsaved Desktop chats never reach the vault.

The vault, folder by folder

Written by Autograph

  • daily_notes/: one note per day, with frontmatter for Obsidian Bases
  • projects/<name>.md: a hub per repo; its commits live beside it
  • sessions/<agent>/: a stub per agent session, or the full saved Desktop chat
  • agents/: one hub per agent
  • Autograph.md and the Index.md files: navigation

Owned by you or other tools

  • vocabulary.md: the terms you allow as tags
  • wiki/: maintained by the wiki jobs, in its own git repo, never pushed
  • personal/memory/ and projects/<repo>/memory/: memory shared by Claude, Codex and Copilot, one fact per file (machine-wide and per repo)
  • deep_dives/: your own write-ups
  • graphify-out/: a generated mirror, hidden in Obsidian and git