When to use
Use when the user asks whether Remnic is running, when recall or store calls start failing, or when diagnosing cross-agent memory issues from Claude Code.
Triggers:
- "Is Remnic running?"
- "Check memory status."
/remnic:statusslash command invocation.- Recall/store tools returned connection errors in this turn.
Inputs
- Optional: specific component to check (daemon, HTTP server, MCP server, store backend).
Procedure
- Check the Remnic health endpoint via the MCP bridge or run
remnic daemon statusin a shell. - Report, in a compact block:
- Daemon running state (PID if known).
- Listening port(s).
- Memory store path.
- Connected clients or plugins, if exposed.
- If the daemon is not running, suggest
remnic daemon startand mention the log path. - If recall/store tools were erroring earlier in the turn, correlate the health state with those errors in one sentence.
Efficiency plan
- One health call per turn is enough; do not poll.
- Skip the check for trivially local tasks.
- Reuse the health payload for downstream troubleshooting within the same turn.
Pitfalls and fixes
- Pitfall: Running
remnic daemon statuson a host where the daemon lives in a container. Fix: Prefer the MCP health endpoint, or run the CLI inside the container. - Pitfall: Reporting "down" from a single failed tool call. Fix: Confirm with the health endpoint before claiming an outage.
- Pitfall: Forgetting the log path. Fix: Always include a pointer to logs on failure.
Verification checklist
- Health was checked via the endpoint or CLI, not guessed.
- Daemon state, port, store path, and clients were reported concisely.
- If unhealthy, the user got a concrete next step.
- Canonical
remnic daemonwording was used over legacyengram daemonwhere the CLI has been renamed.
CLI names: canonical CLI is
remnic daemon. The legacyengram daemoninvocation remains accepted during v1.x.