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:
- Keep your notes folder under version control (git).
- Add a marker such as
???,#ask_claude,#expandor#summarize. - Save a snapshot (a commit). A hook hands the changes to an AI agent.
- The agent edits the note with its answer.
Phone design:
- Write a small tagged block in a note on your phone, such as a research request.
- When your notes sync to the home computer, a file watcher spots the block.
- The task is queued, an agent does the work, and the block is updated with status and results.
What exists today
- Planning notes for the desktop design
- A full design document for the phone design
- One prototype script that watches files and reads the task markers
- A sample notes file showing the marker syntax
What isn't there yet
- The agent worker and the write-back of answers are designed but not confirmed built
- No installer or setup guide
- No tests
- No handling yet for two devices editing the same note at once
- No way to try it without your own notes folder, git and Claude Code
Under the hood
- The desktop version would use a git post-commit hook that calls Claude Code in headless mode
- The phone version uses a Python file watcher, a YAML settings file and a message queue (NATS) between watcher and agent
- Notes stay plain text, so nothing locks you into the tool