Skip to main content

AMC plugin settings and commands

Reference for AMC (Aether Memory Companion), plugin id aether-memory. Obsidian prefixes every command with the plugin name, so Sync vault with Aether appears as AMC: Sync vault with Aether in the Command Palette.

Settings​

SettingDefaultWhat it does
Aether control-plane URLhttp://127.0.0.1:14771Where aether-mcp listens. Plain http:// is accepted only for loopback hosts. Remote servers need https:// and an API key.
API keyEmptyBearer token (aek_...) for servers started with --require-auth. Stored in the plugin's data.json.
Live vault syncOnPushes edits, renames, and deletions after Obsidian finishes loading.
Sync debounce (ms)1500How long to wait after an edit before pushing. Accepts 500 to 10000.
Auto-pull interval (seconds)0Background refresh of Aether/Inbox.md and Aether/Compiled/Approved.md. 0 turns it off.
Run Dream consolidation on pushOffRuns Dream after each push. Needs an Admin key on an authenticated server.
Enable GPU KV-cache warmingOffShows the KV settings and the Warm GPU KV cache command. For people who run their own vLLM or SGLang server.
KV endpoint (optional)EmptyInference endpoint for KV-cache warming.
Default KV modelEmptyModel id sent to POST /v1/kv/warm, for example llama-3.1-8b.

The Connection card at the top of the settings tab checks GET /v1/vault/pull when you open the tab and after you change the URL or key. It shows one of Connected to aether-mcp, Can't reach aether-mcp, The server rejected the API key, or Connection problem.

Commands​

Command IDNameWhat it does
aether-sync-vaultSync vault with AetherPulls the server state, pushes changed public notes and deletions, and writes the updated Inbox and Approved files back.
aether-open-inbox-reviewOpen Aether inbox reviewOpens the inbox pane to approve or reject proposed memories.
aether-trigger-dream-passTrigger dream passCalls POST /v1/dream to extract candidate facts and flag contradictions from Daily Notes.
aether-git-syncGit sync team vaultCalls POST /v1/git/sync. See Share a vault with a team.
aether-warm-kv-cacheWarm GPU KV cacheCalls POST /v1/kv/warm. Only available when KV-cache warming is enabled.

Plugin command IDs and settings keys are stable across releases, so hotkeys and saved settings keep working.

Status bar​

TextMeaning
Aether: IdleConnected, nothing to review.
Aether: Synced (HH:mm)The last sync succeeded at that time.
Aether: N to reviewAgents proposed N memories. Click to open the inbox.
Aether: OfflineThe server is unreachable. Your notes are untouched.

What the plugin sends​

  • Requests go only to the control-plane URL you configure, through Obsidian's requestUrl.
  • Notes with aether_tier: private, paths matched by .aetherignore, and built-in exclusions are filtered on your device before any request is built.
  • The plugin sends no telemetry and spawns no processes.
  • It writes Aether/Inbox.md, Aether/Compiled/Approved.md, and its own data.json inside the vault.