Skip to main content
AI/MLjoeyhipolito

memory

Compiled symbolic memory CLI for AI agents. Use when the user wants to store durable facts, update entity state, search prior notes without embeddings, or inspect the current known state of an entity.

Stars
59
Source
joeyhipolito/nanika
Updated
2026-05-07
Slug
joeyhipolito--nanika--skills
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/joeyhipolito/nanika/HEAD/archive/memory/skills/SKILL.md -o .claude/skills/skills.md

Drops the SKILL.md into .claude/skills/skills.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Memory - Compiled Symbolic Memory

Store and retrieve durable agent memory using an append-only log plus a compiled symbolic index.

Install

cd plugins/memory
go build -ldflags "-s -w" -o bin/memory ./cmd/memory-cli
ln -sf $(pwd)/bin/memory ~/.alluka/bin/memory

When to Use

  • User wants to remember a fact for later
  • User asks what is currently known about a person, project, or entity
  • User wants memory search without embeddings or vector databases
  • User wants durable local memory that is inspectable and rebuildable
  • User wants to recompile or debug the memory index

Configuration

Storage defaults to ~/.memory/default/.

Environment overrides:

  • MEMORY_HOME for the base directory
  • MEMORY_STORE for the logical store name

Commands

Add

memory add "Atlas deploy owner is Alice" --entity Atlas --slot owner=Alice
memory add "Support ticket mentions rate limits" --tag team=support --source zendesk
echo "Piped note" | memory add --entity Atlas

Remember

memory remember Alice --slot employer=OpenAI --slot role=Engineer
memory remember Atlas --slot owner=Platform --text "Atlas ownership confirmed"

Find

memory find "deployment notes"
memory find "entity=alice"
memory find "role=engineer project=alpha" --top 10

Unqualified facets like role=engineer or project=alpha match the shared exact-facet index compiled from slots and tags.

Supported explicit facets:

  • entity=<name>
  • slot.<key>=<value>
  • tag.<key>=<value>
  • day=YYYY-MM-DD

State

memory state Alice
memory state "Project Atlas" --json

Log

memory log
memory log --limit 25 --json

Maintenance

memory rebuild
memory doctor
memory query status --json
memory query items --json
memory query actions --json

Notes

  • Writes are append-only to log.jsonl
  • Reads come from compiled.gob
  • memory rebuild reconstructs the compiled index from the log
  • This plugin is symbolic-first: direct entity state and lexical retrieval, no embeddings required