← The ShowroomLearning & knowledge

Writeup only

Obsidian Agent

A question left in a note gets answered by an AI agent, right inside the note.

Status
Prototype
Built with
Python, git hooks, Claude Code
Last worked on
2026-01

What it is

Obsidian Agent is an idea for treating a notes app as an inbox for an AI helper. Obsidian is a popular notes app that stores everything as plain text files. You type a marker next to a thought, like ??? after a question or #expand after a rough paragraph, and later find the answer or the expanded text waiting in the same note. There are two designs: one that runs when you save a snapshot of your notes, and one aimed at jotting tasks on your phone that get handled when the notes sync back to a home computer.

How it works

Desktop design:

  1. Keep your notes folder under version control (git).
  2. Add a marker such as ???, #ask_claude, #expand or #summarize.
  3. Save a snapshot (a commit). A hook hands the changes to an AI agent.
  4. The agent edits the note with its answer.

Phone design:

  1. Write a small tagged block in a note on your phone, such as a research request.
  2. When your notes sync to the home computer, a file watcher spots the block.
  3. The task is queued, an agent does the work, and the block is updated with status and results.

What exists today

What isn't there yet

Under the hood