Get Remnic running in 60 seconds.

1 Install the CLI

npm install -g @remnic/cli

Installs the remnic binary globally. Remnic was formerly called engram, so older setups may still reference the old name (see the rename notes).

2 Start the daemon

remnic daemon install

Installs Remnic as a background service (launchd on macOS, systemd on Linux) and starts it immediately. Verifies the server is healthy and sets up auto-start on boot.

remnic daemon status
# ✓ Remnic server running on :4318
# ✓ Memory store: ~/.remnic/memory/
# ✓ Auto-start: enabled

3 Connect your agents

Each connector installs the native plugin for that platform, generates a dedicated auth token, and runs a health check. Install one or all of them. Your memories are shared across every agent.

remnic connectors install claude-code

remnic connectors install codex-cli

remnic connectors install pi

pip install --upgrade remnic-hermes
remnic connectors install hermes

openclaw plugins install \
  clawhub:@remnic/plugin-openclaw
remnic openclaw install

# Add to the client's MCP config
{"remnic":{"url":"http://localhost:4318/mcp"}}

remnic connectors install replit

4 Bring existing memory

Optional importer packages let Remnic start with memory you already built elsewhere. Install only the sources you use.

# ChatGPT saved memories and optional conversation summaries
npm install -g @remnic/import-chatgpt
remnic import --adapter chatgpt --file ~/chatgpt-export/memory.json --dry-run

# Claude project docs and prompt templates
npm install -g @remnic/import-claude
remnic import --adapter claude --file ~/claude-export/projects.json

# Google Takeout Gemini Apps Activity
npm install -g @remnic/import-gemini
remnic import --adapter gemini --file "~/Takeout/Gemini/My Activity.json"

# mem0 REST API
npm install -g @remnic/import-mem0
export MEM0_API_KEY=...
remnic import --adapter mem0 --rate-limit 2

# Supermemory JSON export
npm install -g @remnic/import-supermemory
remnic import --adapter supermemory --file ./supermemory-memories.json --dry-run

Use --dry-run first when you want a zero-write preview. Import parsing runs locally; extraction uses the model provider you configured for Remnic.

See the migration hub for per-source guides and the full list of supported exports.

5 Verify everything

remnic connectors doctor
# ✓ claude-code: connected, 44 tools available
# ✓ codex-cli:   connected, 44 tools available
# ✓ pi:          connected, extension active
# ✓ hermes:      connected, MemoryProvider active
# ✓ replit:      token generated

Any failure comes with a remediation hint. You can also open http://127.0.0.1:4318/remnic/ui/ for a lightweight operator UI that lets you browse memories, inspect recall, review governance, and promote trust-zone records.

✓ Start using it

Remnic now works automatically:

• Start a session: Remnic recalls your preferences and project context
• Type a prompt: Remnic injects relevant memories before the LLM call
• Edit files: Remnic observes and learns patterns
• Switch tools: memories carry over instantly

Configuration

Remnic reads config from REMNIC_CONFIG_PATH, ./remnic.config.json, or ~/.config/remnic/config.json. Ninety-plus properties cover search backends, capture modes, Memory OS features, namespaces, governance, and more. Presets cover the common cases:

• conservative: tight extraction gate, strict dedup, small recall budget
• balanced: sensible defaults for most users
• research-max: every optional Memory OS feature enabled
• local-llm-heavy: tuned for fully offline operation on local LLMs

Full reference: docs/config-reference.md.

From source

Remnic is an MIT-licensed TypeScript monorepo using pnpm workspaces.

git clone https://github.com/joshuaswarren/remnic.git
cd remnic
pnpm install && pnpm run build
cd packages/remnic-cli && pnpm link --global

Requires Node.js 22.12+ and pnpm.