agent-memory (v0.1)

A persistent knowledge layer for AI coding agents.

What is implemented

• CLI commands: init, add, context, search, forget, stats, export
• Filesystem-backed knowledge store at .agent-memory/
• Default categories:
  • architecture
  • decisions
  • conventions
  • gotchas
  • dependencies
  • debugging-log
• Deterministic entry IDs ({category}-{slug}-{hash})
• Soft delete via status: deprecated
• Adapters for:
  • Claude (CLAUDE.md)
  • Cursor (.cursorrules)
  • Codex (AGENTS.md)
• init --dry-run preview mode

Development

npm install
npm run typecheck
npm run lint
npm run test
npm run build

Run CLI in dev mode:

npm run cli -- --help

Example

npm run cli -- init
npm run cli -- add gotchas "Paystack webhooks can duplicate events" --confidence high --tags payments,webhooks
npm run cli -- search paystack
npm run cli -- context claude
npm run cli -- stats
npm run cli -- export