Get started

Install eidetic-daemon

Pre-built binaries for darwin-arm64, linux-amd64, linux-arm64, and windows-amd64. Single static binary, no CGO. Pick a path below.

One-liner (macOS + Linux)

curl -fsSL https://eidetic.works/install.sh | sh

The script detects your OS + arch, downloads the matching release artifact from GitHub, places the binary in /usr/local/bin/eideticd, and auto-registers the launchd (macOS) or systemd-user (Linux) service. The daemon starts immediately and begins capturing on next session write.

Read what the script does at scripts/install.sh before piping it to sh, if that's your style.

Homebrew (macOS, recommended)

brew tap eidetic-works/nucleus
brew install eideticd

Homebrew formula auto-updates on every tag push (v0.0.43+). After install, register the service with one command:

eideticd -install   # launchd on macOS, systemd-user on Linux

Windows (PowerShell)

irm https://eidetic.works/install.ps1 | iex

No admin required. Downloads eideticd-windows-amd64.exe from the latest GitHub release, installs to %LOCALAPPDATA%\EideticWorks\bin\, registers an HKCU Run key for login-startup, and starts the daemon in TCP mode (the only supported mode on Windows).

Manual download

All releases live at github.com/eidetic-works/eidetic-daemon/releases. Artifacts:

eideticd-darwin-arm64.tar.gz — Apple Silicon (M1/M2/M3/M4)
eideticd-linux-amd64.tar.gz — x86-64 Linux
eideticd-linux-arm64.tar.gz — ARM64 Linux (Graviton, RPi 4/5, Oracle Cloud free tier)
eideticd-windows-amd64.zip — Windows x86-64

Extract, move the eideticd binary into your PATH, then eideticd -install to register the service.

MCP bridge (Claude Code / Cursor / Cline / any MCP client)

The Python bridge is shipped separately from the daemon, so the daemon's crash surface stays isolated.

pip install eidetic-mcp
claude mcp add eidetic -- python -m eidetic_mcp.server

For Cursor / other MCP clients, add the same command under their mcpServers config. See MCP tools for the full tool reference, and nucleus_ask recipes for natural-language recall setup.

Verify

# Confirm the daemon is alive
curl --unix-socket /tmp/eidetic-daemon.sock http://localhost/healthz
# → {"status":"ok"}

# See your engram stats
eideticd --stats

# All surfaces with engram counts
curl --unix-socket /tmp/eidetic-daemon.sock http://localhost/surfaces

Uninstall

Symmetric to install — one command stops the service, removes the launchd plist or systemd-user unit, then prompts to delete the data directory.

eideticd -uninstall          # interactive: prompts y/N before deleting data
eideticd -uninstall -purge   # unattended: skip prompt, delete <dataDir>

For Homebrew installs, finish with brew uninstall eideticd to remove the binary itself.