Aether documentation
Aether gives your AI agents memory from your Obsidian vault.
AMC (Aether Memory Companion) is the Obsidian plugin.
aether-mcp is the local server that indexes your notes and serves them to any MCP-compatible agent, such as Cursor, Claude Desktop, Claude Code, or Antigravity.
- Your notes sync automatically.
- Notes marked
aether_tier: privatestay on your disk. - Facts an agent proposes wait in an inbox until you approve them.
Start here
- Quickstart. Get an agent recalling your notes in about five minutes.
- Install aether-mcp. The installer with guided setup, the global npm package, or Docker.
- Install AMC. Plugin install, connection, and first sync.
- Connect an AI agent.
stdioor HTTP, and the three MCP tools.
Guides
- AMC walkthrough. Screenshots and a demo recorded from a real vault.
- Organize and protect your notes. Tiers, private notes,
.aetherignore, and.aetherhot. - Review what your agent wants to remember. The inbox and Dream pass.
- Share a vault with a team. Authenticated gateway, scoped keys, and Git sync.
- Troubleshooting. Connection, authentication, and sync problems.
Reference
- aether-mcp CLI and MCP tools. Flags, environment variables, subcommands, and tool schemas.
- HTTP API. All 19 control-plane endpoints and their roles.
- Vault files and frontmatter. Frontmatter keys,
.aetherignore, and.aetherhot. - AMC plugin settings and commands. Settings, commands, and status bar states.
Build with the Rust SDK
Aether is also a model-free Rust SDK (muninn-aether-*) for record durability, vector search, temporal knowledge graphs, and prefix-cache-friendly MCP serving.
- Learning series. Five tutorials from your first memory to team Git sync and KV warming.
- Usage guide and memory model. Snippets across all five SDK levels.
- Crates, traits and APIs, storage backends and flags, and observability.
Concepts and architecture
- Concepts overview. The model-free, pieces-first design, scopes and tiers, hybrid recall, and KV-cache layout.
- Architecture and ADRs. Design records for the SDK, connectors, hardening, and the vault server.