Know the basics
- AGENTS.md: a single file that teaches agents how to operate in your vault.
- Agent Skills: reusable instruction packages agents discover and follow as needed.
- Markdown formatting basics like headings, links, lists, and checkboxes.
How to set it up
1. Install Obsidian and create a new vault, or use an existing one.
2. Set up a coding agent in your vault directory. Popular options: Claude Code, Claude Cowork, Codex, Cursor, or Windsurf.1
3. Put the AGENTS.md file in the root of your vault directory.
4. Tell the agent: "Read AGENTS.md in full and set up the vault."
5. A superpaper folder will appear in your vault. That's where agents keep everything they work on with you.
6. Make it yours, it's only a starting point. Shape it around how you think, work, learn, and live, and it will grow with you.
1 Optionally, add Obsidian MCP for Claude and ChatGPT, and keep the same AGENTS.md instructions in your project for best results.
Tips
- Point your vault at a folder with your projects so the agent can see and work on them with you.
- Obsidian runs on Windows, macOS, iOS, and Android, so your notes and agents stay in one place.
- If you like the terminal, the obsidian-terminal plugin lets you run agents from inside Obsidian.
- The Obsidian Web Clipper collects links and bookmarks straight into your vault.