What Waykeep records
Hooks and MCP tools retain useful records such as pitfalls, decisions, corrections, facts, patterns, goals, and plan state, with provenance.
Documentation
Keep moving.
Install the local core, understand what it records, or inspect the boundary before you wire it into your work.
Quickstart
Three commands. One local memory.
Install the published package, wire the supported agent hooks, then check the whole path.
-
01
Install the package
npm install -g waykeep -
02
Initialize agent wiring
waykeep init -
03
Run the health check
waykeep doctor
Choose a path
Go straight to the work in front of you.
Use with Claude Code
Install the plugin or wire the supported hooks directly.
Open guideUse with Codex CLI
Wire MCP and lifecycle hooks, then approve the entries once.
Open guideUnderstand memory
See the record types, provenance, confidence, and truth maintenance.
Inspect memoryRun multiple agents
Use the local daemon so concurrent agents share one responsive store.
Read daemon guideWaykeep Team
Understand exactly what hosted sync changes and what remains local.
Read the boundaryArchitecture at a glance
The local loop comes first.
Hooks and tools record useful context locally. The next session receives a briefing or warning; Team is an optional paid branch.
- 1 · Agent hooks and toolsClaude Code and Codex record decisions, corrections, failures, and plans.
- 2 · Local memory engineSQLite, full-text search, and local embeddings keep the free core on your machine.
- 3 · Next briefing or warningRelevant context returns at session start or before a repeated pitfall.
- Optional · Waykeep TeamEligible project memory follows an entitlement-gated hosted sync path.
Reference index
Known destination, short route.
Truth and limits
Inspect the boundary before adoption.
What stays local
The free core, SQLite database, full-text index, and embeddings run locally. Private-project content is excluded from other project contexts and Team sync.
What Team sync changes
Eligible memory for an enrolled project can flow to entitled members through hosted, eventually consistent sync. Losing entitlement returns clients to local-only operation.
Help