Set up Mind on your devices

Mind is a personal knowledge graph. You dump thoughts, articles, code snippets, anything — it classifies into a Neo4j graph, and you (or an agent) can query it later. All access is gated by passkeys registered on your source-of-truth device (your phone).

1. Register your phone (source of truth)

If you haven't already, your iPhone needs to be the first device registered. This is a one-time step and becomes the device that approves every other device/CLI/MCP token.

On the VM (via SSH), get a one-time setup URL:

curl -sX POST https://mind.eliogerges.com/auth/bootstrap-setup-url

Valid for 30 minutes, single-use. Refuses to return anything once any passkey is registered.

Open the returned URL in iPhone Safari. Name the device, tap Save passkey — iOS saves it to iCloud Keychain so every Apple device signed into your Apple ID inherits it.

Save the 10 recovery codes shown. These are your only way back in if your phone is lost.

2. Install the menubar app (macOS)

Quick dump + query from anywhere on your Mac. Live status dot in the menu bar.

gh release download menubar-v0.2.2 --repo egerges/mind --pattern Mind.app.zip --dir ~/Downloads --clobber
cd ~/Downloads
unzip -o Mind.app.zip
xattr -dr com.apple.quarantine Mind.app
mv Mind.app /Applications/
open /Applications/Mind.app

Click the brain icon in your menu bar → Register This Device… → copy the approval link → paste it on your phone (or any device signed into Mind) → tap Approve. The icon flips to green once registered.

3. Install the CLI (macOS / Linux)

Apple Silicon or Linux x86_64 — download the prebuilt binary:

# Apple Silicon
gh release download cli-v0.2.1 --repo egerges/mind --pattern mind-darwin-arm64 --dir /tmp --clobber
chmod +x /tmp/mind-darwin-arm64 && sudo mv /tmp/mind-darwin-arm64 /usr/local/bin/mind

# Linux
gh release download cli-v0.2.1 --repo egerges/mind --pattern mind-linux-x64 --dir /tmp --clobber
chmod +x /tmp/mind-linux-x64 && sudo mv /tmp/mind-linux-x64 /usr/local/bin/mind

Intel Mac — build from source (prebuilts aren't published for Intel due to GitHub runner cost):

gh repo clone egerges/mind ~/mind-src
cd ~/mind-src && npm install && cd cli && npm run build
chmod +x dist/index.js
sudo ln -sf "$PWD/dist/index.js" /usr/local/bin/mind

Then authenticate:

mind auth --server https://mind.eliogerges.com

CLI prints a URL + code; open it on your phone or the dashboard to approve. Token stored in OS keychain. Then mind dump "...", mind query "...", mind status all work.

4. Configure MCP for Claude (Desktop / Code)

MCP exposes four tools to your Claude clients: mind_dump, mind_query, mind_status, mind_gap_fill. Each client needs a signed MCP URL with a scoped token.

Generate a scoped MCP URL now

Uses your current dashboard session to auto-approve. The resulting key appears on Keys and can be revoked any time.

Paste the URL into your client config. Examples:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mind": {
      "url": "https://mind.eliogerges.com/mcp?token=PASTE_YOUR_TOKEN_HERE"
    }
  }
}

Claude Code (from terminal):

claude mcp add mind "https://mind.eliogerges.com/mcp?token=PASTE_YOUR_TOKEN_HERE"

Prefer the CLI? Run mind mcp-config — same flow, URL lands in your clipboard.

5. Per-device security

Every client (menubar, CLI, MCP) has a separate token on the server. From Sessions you can:

See every active device + its last-seen time and IP
Revoke a single device (from a stolen laptop, say)
Hit Panic — Sign out everywhere which nukes every token except your source-of-truth device's
Regenerate your 10 recovery codes (invalidates the old set)

Agent / automation keys (long-lived, scoped) live on Keys — create one with only dump:write for a backup script, etc.