HGM - HaGi Mind

Project memory layer for AI agents.

hgm creates a portable .hagi-mind/ folder inside any project so AI agents and IDE assistants can record decisions, changes, sessions, and durable project context.

Quick use

Preferred package name after publish:

npx -y hgm add .

Fallback package name if hgm is unavailable:

npx -y @hagione/hgm add .

Local development:

npm install
npm run build
node dist/cli.js add . --lang vi --mode light --qmd if-present --yes

Core commands

User-facing:

hgm add <project>
hgm status
hgm search "query"
hgm doctor
hgm qmd status
hgm qmd sync

Agent-facing:

hgm remember "Project uses Next.js App Router"
hgm decision "Use light mode for MVP because QMD is optional"
hgm change "Added script-first workflow stage"
hgm task "Implement qmd sync wrapper"
hgm done "Implemented CLI MVP"
hgm session start
hgm session end --summary "Finished baseline audit"

Design decisions

• Primary npm package: hgm
• Fallback npm package: @hagione/hgm
• Binary: hgm
• Main command: hgm add <project>
• Storage: project-local .hagi-mind/
• QMD: optional external integration, not bundled
• Display language: selected first in wizard, saved as vi or en
• AI-agent-first: agents proactively record context after the project is added

.hagi-mind/ structure

.hagi-mind/
├── config.json
├── manifest.json
├── index.md
├── log.md
├── agent.md
├── memories.jsonl
├── sessions/
├── decisions/
├── changes/
├── tasks/
├── audits/
├── baselines/
├── qmd/
├── cache/
└── tmp/

MVP scope

Phase 1 implements:

• TypeScript npm CLI skeleton
• hgm add
• hgm status
• agent write commands: remember, decision, change, task, done
• session start/end
• qmd status
• local file-backed memory

Phase 2 implements:

• QMD sync/index wrapper via hgm qmd sync
• hgm search with local memory fallback
• hgm search --qmd wrapper around qmd query

Phase 3 should implement:

• hgm ask
• model/mode management
• package publish workflow