How asekepc/mind-skill works
Mind Skill is a local-first project-memory tool for coding agents. A user initializes a project, then an agent records checkpoints and source-backed architecture facts; lifecycle hooks can capture progress and deliver a compact handoff, while CLI and MCP provide explicit read/write access. The map separates onboarding and agent integration from memory workflows, persistence, and optional mirrors. Major documented features such as manifest scanning, import/export, search, and Claude Mem support are represented. Some command and hook relationships rely on the source index or README because those implementations were only partly sampled.
Main entry points: store.cjs Memory service · mind.cjs Mind CLI · packet.cjs Handoff packet · hooks.cjs Lifecycle hooks
Components 21
Agent Integration
- Mind CLI
skills/mind-skill/scripts/mind.cjs - CLI entry
bin/mind.cjs - Agent installer
skills/mind-skill/lib/install.cjs - Lifecycle hooks
skills/mind-skill/lib/hooks.cjs - Hook dispatcher
skills/mind-skill/lib/dispatch.cjs - MCP server
skills/mind-skill/lib/mcp.cjs - Agent instructions
skills/mind-skill/SKILL.md
Memory Workflows
- Memory service
skills/mind-skill/lib/store.cjs - Manifest scanner
skills/mind-skill/lib/scan.cjs - Handoff packet
skills/mind-skill/lib/packet.cjs - Safe file utilities
skills/mind-skill/lib/io.cjs
Local Persistence
- Project facts
- Task state
- Change journal
Optional Mirrors
- SQLite mirror
skills/mind-skill/lib/sqlite.cjs - Claude Mem mirror
skills/mind-skill/lib/claude-mem.cjs
Other components
- Project user
- Coding agent
- Claude Mem worker
- Project manifests
- MCP client
Connections 30
- Project user → Mind CLI: runs commands
skills/mind-skill/scripts/mind.cjs - CLI entry → Mind CLI: delegates to
bin/mind.cjs - Mind CLI → Memory service: invokes
skills/mind-skill/scripts/mind.cjs - Mind CLI → Agent installer: configures agents
skills/mind-skill/scripts/mind.cjs - Mind CLI → Handoff packet: builds context
skills/mind-skill/scripts/mind.cjs - Mind CLI → MCP server: serves protocol
skills/mind-skill/scripts/mind.cjs - Project user → Coding agent: asks to preserve
README.md - Coding agent → Agent instructions: follows
README.md - Agent installer → Hook dispatcher: installs hooks
skills/mind-skill/lib/install.cjs - Hook dispatcher → Lifecycle hooks: dispatches events
skills/mind-skill/lib/dispatch.cjs - Lifecycle hooks → Memory service: records progress
skills/mind-skill/lib/hooks.cjs - Lifecycle hooks → Handoff packet: creates packet
skills/mind-skill/lib/hooks.cjs - Lifecycle hooks → Coding agent: delivers context
README.md - MCP client → MCP server: sends tools
README.md - MCP server → Memory service: reads and writes
skills/mind-skill/lib/mcp.cjs - MCP server → Handoff packet: formats context
skills/mind-skill/lib/mcp.cjs - Memory service → Manifest scanner: refreshes facts
skills/mind-skill/lib/store.cjs - Manifest scanner → Project manifests: scans manifests
skills/mind-skill/lib/scan.cjs - Memory service → Safe file utilities: persists safely
skills/mind-skill/lib/store.cjs - Manifest scanner → Safe file utilities: checks source files
skills/mind-skill/lib/scan.cjs - Memory service → Project facts: updates facts
skills/mind-skill/lib/store.cjs - Memory service → Task state: updates checkpoints
skills/mind-skill/lib/store.cjs - Memory service → Change journal: journals changes
- Handoff packet → Project facts: selects facts
skills/mind-skill/lib/packet.cjs - Handoff packet → Task state: selects progress
skills/mind-skill/lib/packet.cjs - Memory service → SQLite mirror: syncs mirror
skills/mind-skill/lib/store.cjs - Memory service → Claude Mem mirror: queues saves
skills/mind-skill/lib/store.cjs - Claude Mem mirror → Claude Mem worker: posts notes
skills/mind-skill/lib/claude-mem.cjs - Mind CLI → SQLite mirror: exports data
skills/mind-skill/scripts/mind.cjs - Mind CLI → Memory service: imports data
skills/mind-skill/scripts/mind.cjs