What problem does it solve?
Minni is a local-first memory system for AI agents, but when it malfunctions, users often can't tell if the root cause is the daemon, vault, plugin wiring, hooks, or another component — leading to hours of guesswork and wasted troubleshooting time. This skill eliminates that frustration by running a systematic, layer-by-layer health diagnostic that identifies the exact root cause of any Minni issue, with concrete evidence to back up every finding, and never makes silent unapproved changes to your system.
Core Features & Use Cases
- Ordered Layer-by-Layer Checks: Runs 8 sequential diagnostic checks (daemon/socket/DB, vault, plugin/MCP wiring, hooks, identity, inbox lifecycle, model providers, plans) ordered by dependency, so lower-layer failures don't cause false positives for higher layers.
- Evidence-Based Reporting: Every finding includes concrete proof like file paths, RPC output, and file counts, so you never get a vague "looks fine" response without an actual check being run.
- Clear Repair Routing: Automatically routes repair actions to the minni-install tool for config issues, or escalates engine-internal problems to a human, with no unapproved state changes.
- Use Case: If your agent can't recall past corrections you gave it in a previous session, handoffs between Claude Code and Codex are failing, or new pages you write to your Minni vault aren't showing up in recall, this skill will tell you exactly which layer is broken and what to do about it.
Quick Start
Use the minni-doctor skill to run a full health diagnostic on your local Minni installation and get a prioritized list of all identified issues with evidence and fix recommendations.