Named Agents & Memory

Give an agent a name and it remembers context across sessions:

# First session — agent learns about your project
npx agntk -n myproject "read the codebase and understand the architecture"

# Later session — agent already knows the context
npx agntk -n myproject "add rate limiting to the API endpoints"

# See what agents exist
npx agntk list

Memory is stored at ~/.agntk/agents/{name}/ as plain markdown files:

Path	Description
memory/memory.md	Agent-curated facts about your project
memory/decisions.md	Append-only log of decisions made
memory/preferences.md	Cross-project preferences
memory/identity.md	Human-authored identity (you can edit this)
memory/project.md	Human-authored project context
context.md	Session context the agent rewrites as it learns

---