Install

Get Remnic running in 60 seconds.

One daemon, every agent. Install the CLI, start the daemon, and connect the tools you use — all from the terminal. macOS, Linux, and Windows (WSL) supported. Requires Node.js 22+.

1 Install the CLI

npm install -g @remnic/cli

Installs the remnic binary globally. The legacy engram command name is also registered as a forwarder during the v1.x transition window.

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.

Claude Code

remnic connectors install claude-code

Hooks (SessionStart, UserPromptSubmit, Stop, SessionEnd) + MCP + skills.

Codex CLI

remnic connectors install codex-cli

Hooks + MCP + phase-2 memory extension for consolidation.

Hermes Agent

pip install remnic-hermes
remnic connectors install hermes

Python MemoryProvider. Structural recall every turn.

OpenClaw

openclaw plugins install \
  @remnic/plugin-openclaw --pin
remnic openclaw install

Memory slot plugin with auto-configuration.

Cursor, Cline, Windsurf, Amp

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

Any MCP-compatible client. See the MCP setup guide.

Replit Agent

remnic connectors install replit

MCP only. Configure the token in Replit's Integrations pane.

4 Verify everything

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

Any failure comes with a remediation hint. You can also open http://127.0.0.1:4318/engram/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
Try it: In Claude Code, run /engram:remember I prefer functional patterns over OOP. Then open Codex CLI and start a new session — it already knows.

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.

Star on GitHub Explore features ♡ Sponsor