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.
- Claude Code
- Codex CLI
- Copilot CLI · Pi
- Claude Desktop you say: autograph this
- Git repos
- ~/.claude · ~/.codex ~/.copilot · ~/.pi
- ~/.autograph/ desktop-captures
- Session observer always on
- 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 cleanup Mon 09:00
- daily_notes/
- projects/ + commits/
- sessions/ · agents/
- wiki/ own local git repo
- vocabulary.md you curate
- Wiki jobs dream 07:00 · ingest 12:30 lint Mon 12:00
- Obsidian graph + Bases
- Vault git remote
- Claude Desktop you say: autograph this leads to ~/.autograph/ desktop-captures: capture tool
- Git repos leads to Session observer always on: new commit
- Session observer always on leads to projects/ + commits/: session context
- Claude Desktop you say: autograph this leads to sessions/ · agents/: full note
- Vault cleanup Mon 09:00 leads to Vault · ~/.autograph/vault: removes only files with no value (lookups)
- 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
Inside the 08:00 job
What run_daily_backfill.py does, in order:
- Collect. Reads every agent’s session files, saved Claude Desktop chats and git commits from the last 7 days.
- Clean. Drops tool and system messages, duplicates and empty lines. Finds each record’s project from the folder it ran in.
- Group. Splits the work into units per project and session, cutting long sessions at idle gaps.
- Skip what’s current. A fingerprint per day means an unchanged day is left alone and costs no Ollama calls.
- 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.
- 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. - Write notes. A daily note with frontmatter, plus commit, session, project and agent notes.
- 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.
- Claude Desktop capture suggests tags
- note tags
- proposed_tags, plus an unticked line in vocabulary.md
- You tick it, retire it, or leave it
- vocabulary.md 276 terms, from SWEBOK, NIST SSDF, OWASP, DORA, MCP
- run_daily_note_retrofit.py refresh old notes, no Ollama
- Daily notes tags + Related wiki
- wiki-lint, Mondays flags off-vocabulary tags
- wiki-ingest fixes those pages
- Claude Desktop capture suggests tags leads to note tags: known term
- 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
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.
| When | Job | What it does |
|---|---|---|
| At login | Session observer | Watches agent sessions; on each new commit, adds the session context to that commit’s note. |
| Daily 07:00 | wiki-dream | Applies 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:00 | Daily notes | The 8 steps above, for the last 7 days. |
| Mon 09:00 | Vault cleanup | Removes empty placeholders, redundant legacy notes and empty folders. Never anything with content of its own. |
| Mon 12:00 | wiki-lint | Checks wiki pages, including tags against vocabulary.md. |
| Daily 12:30 | wiki-ingest | Brings new and changed plans, memory and repo docs into wiki/. |
Commands you run yourself
| Command | When to use it |
|---|---|
run_daily_note_retrofit.py | After ticking or retiring vocabulary terms: refreshes tags and wiki links on every daily note, without Ollama. |
run_vault_cleanup.py --dry-run | See what the Monday cleanup would remove, and why. |
run_daily_backfill.py --days 14 --replace-generated | Rewrite generated notes from scratch. One Ollama call per work unit, and it pushes the vault. |
| “autograph this” in Claude Desktop | Save 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 Basesprojects/<name>.md: a hub per repo; its commits live beside itsessions/<agent>/: a stub per agent session, or the full saved Desktop chatagents/: one hub per agentAutograph.mdand theIndex.mdfiles: navigation
Owned by you or other tools
vocabulary.md: the terms you allow as tagswiki/: maintained by the wiki jobs, in its own git repo, never pushedpersonal/memory/andprojects/<repo>/memory/: memory shared by Claude, Codex and Copilot, one fact per file (machine-wide and per repo)deep_dives/: your own write-upsgraphify-out/: a generated mirror, hidden in Obsidian and git
Follows the thread to
- How Claude, Codex, Copilot and Gemini talk to each other
- How this site works, part 1: from constants to pages
- Old knowledge into new work, part 2: the library draws itself
- Old knowledge into new work, part 1: the loop watched the wrong thing
- My Claude Code setup: guardrails, a plan gate, shared memory and a wiki that dreams
- Autograph
- Lunchit