agents-memo

agents-memo

Obsidian wiki plugin for AI coding agents — personal knowledge vault with LLM-assisted ingestion, research, and retrieval.

%%{init: {'theme':'base', 'themeVariables': {'background':'#000','primaryColor':'#ffffff','primaryTextColor':'#000000','primaryBorderColor':'#000000','lineColor':'#000000','textColor':'#000000','titleColor':'#000000','clusterBkg':'#f3f4f6','clusterBorder':'#000000','edgeLabelBackground':'#ffffff'}}}%%
flowchart
  subgraph Canvas["Plugin flowchart"]
    direction LR TB

    subgraph Skills["Skills"]
      direction LR
      Skill_Note["/note"]
      Skill_Dump["/dump"]
      Skill_Daily["/daily"]
      Skill_Brain["/braindump"]
      Skill_Canvas["/canvas"]
      Skill_Drop["drop files to .raw/"]
      Skill_Ingest["/ingest"]
      Skill_NoteProc["/note process"]
      Skill_DailyClose["/daily-close"]
      Skill_Save["/save"]
      Skill_Auto["/autoresearch"]
    end

    subgraph Store["Vault"]
      direction BT
      Store_Hot[("hot.md")]
      Store_Index[("index.md")]
      Store_Wiki["wiki/"]
      Store_Daily["daily/"]
      Store_Notes["notes/"]
    end

    subgraph Maintain["Maintenance"]
      M_Lint["/lint"]
    end

    subgraph Retrieve["Retrieve"]
      Retrieve_Query["Obsidian query"]
    end

    subgraph Hooks["Passive hooks"]
      Hook_SessionEnd["SessionEnd hook"]
      Hook_Commit["auto-commit"]
      Hook_SessionStart["SessionStart hook"]
    end

    Skills -- write --> Store
    Store -- read --> Retrieve
    Store -- changes --> Store_Hot

    Store_Hot -. injects .-> Hook_SessionStart
    Skills -. on write .-> Hook_Commit
    Hook_SessionEnd -. on stop .->  Store

    Store -. cron .-> M_Lint
    M_Lint -. fix .-> Store

  end

  classDef canvas fill:#ffffff,stroke:#ffffff,color:#000000
  classDef orch fill:#dddddd,stroke:#000000,stroke-width:2px,color:#000000
  classDef spec fill:#eeeeee,stroke:#000000,stroke-width:2px,color:#000000
  classDef store fill:#a5b4fc,stroke:#000000,stroke-width:2px,color:#000000
  classDef passive fill:#f9a8d4,stroke:#000000,stroke-width:2px,stroke-dasharray:4 2,color:#000000
  class Canvas canvas
  class Skills,Retrieve,Maintain,Store orch
  class Skill_Note,Skill_Dump,Skill_Daily,Skill_Brain,Skill_Drop,Skill_Ingest,Skill_NoteProc,Skill_DailyClose,Skill_Save,Skill_Auto,Retrieve_Query,Hook_SessionStart,M_Lint,Skill_Canvas,Hook_Commit,Hook_SessionEnd spec
  class Store_Hot,Store_Index,Store_Wiki,Store_Daily,Store_Notes store
  class Hooks passive

Legend: phase orchestrators (medium gray subgraphs) wrap specialist skills (light gray). The wiki itself (indigo) is the compounding store every phase reads from or writes to. Passive hooks (dashed pink) run silently on session events.

Install

Prerequisites: Obsidian 1.12.7+ and the Obsidian CLI binary on your PATH.

Plugin installation:

claude plugin marketplace add misiekhardcore/agents-memo
claude plugin install agents-memo@agents-memo

Vault registration:

1. Set vault_path when Claude Code prompts for user configuration
2. Register your vault: obsidian register vault=/absolute/path/to/vault
3. Verify: obsidian list vaults

See _shared/setup.md for troubleshooting and Flatpak setup.

Skills

• wiki — bootstrap / health-check the vault
• ingest — parallel batch ingestion of sources
• query — answer questions from vault content
• lint — find orphan pages, dead links, stale claims
• save — save the current conversation or insight into the vault
• notes — quick inbox capture (/note, /dump); list and process flows for triage
• daily — append-only chronological log (/daily); timestamped bullets in daily/YYYY-MM-DD.md
• daily-close — end-of-day synthesis (/daily-close, "close today", "wrap up today"); appends a polished ## Summary to today's daily file, idempotent on re-run
• braindump — split long-form text into atomic notes (/braindump, "brain dump this", "split this into notes"); each chunk filed via the full capture pipeline
• autoresearch — autonomous iterative research loop
• canvas — create / update Obsidian canvas files
• defuddle — strip clutter from web pages before ingestion
• obsidian-markdown — correct Obsidian-flavored Markdown (wikilinks, embeds, callouts)
• obsidian-bases — create / edit .base files

Vault structure

<vault_path>/
  wiki/          agent-generated knowledge (hot.md, index.md, concepts/, entities/, sources/)
  notes/         inbox: verbatim quick-capture notes (owned by `notes` skill)
  daily/         chronological daily log — one file per day (owned by `daily` skill)
  .raw/          immutable source documents + .manifest.json
  _templates/    Obsidian Templater templates
  _attachments/  images + PDFs referenced by wiki pages
  .obsidian/     (user-owned) Obsidian app config

Hooks

The plugin auto-runs passive automations via hooks/hooks.json: