Reference
The memory model, commands, and configuration.
How the memory system works
pk gives your AI agent persistent memory for each project. Notes are stored locally as plain markdown — searchable, diffable, and readable by both you and your agent. Nothing leaves your machine.
pk separates two kinds of memory: what you know, and what happened.
Notes, decisions, questions
Structured markdown indexed for full-text and semantic search. Your agent queries these to answer questions about the project.
Git history
Every pk command is recorded as a git commit. Your agent can reconstruct a timeline — who asked what, when, and what changed.
The semantic store answers "what did we decide about the database?" The episodic store answers "when did we make that call, and what happened right before it?"
Knowledge lives in .pk/ — local by default, or in ~/.pk/<name>/ with --global. .pk/config.json records which store the project uses.