Local commands

These commands manage your local .tekmemo/ folder.

init

Creates the .tekmemo/ directory and canonical memory files.

npx tekmemo init

Options:

• -f, --force Overwrite existing seed files
• -p, --project-id <id> Explicit project ID
• --no-input Skip interactive prompts

inspect

Summarizes the current local memory state, including file sizes and record counts.

npx tekmemo inspect

remember

Stores a durable note for humans or coding agents.

npx tekmemo remember "Use VoyageAI for embeddings" \
  --kind decision \
  --tag architecture \
  --source "team meeting"

Options:

• --stdin Read memory content from standard input
• --file <path> Read memory content from a file
• -k, --kind <kind> Type of memory (decision, constraint, goal, preference, reference, summary, note)
• --title <title> Optional note title
• -t, --tag <tag> Tag to attach (can be used multiple times)
• --confidence <n> Confidence from 0 to 1
• --source <source> Source identifier (file, URL, or agent name)
• --actor <actor> Actor type (e.g. agent:claude-code)
• --metadata-json <json> Custom metadata JSON object
• --allow-secrets Allow content that looks like a secret

context

Packs project memory into an agent-friendly context block.

npx tekmemo context --query "database schema work" --max-chars 8000

Options:

• -q, --query <query> Prioritize lines matching a task or query
• --max-chars <n> Maximum output characters (default: 12000)
• --include-events Include recent memory events
• --include-chunks Include recent chunk records

read

Reads a canonical memory document.

npx tekmemo read core
npx tekmemo read notes
npx tekmemo read manifest

events

Reads the memory event log.

npx tekmemo events --limit 10

Options:

• -l, --limit <n> Limit number of events
• -s, --strict Strict protocol validation

chunks

Reads the local chunk index.

npx tekmemo chunks

Options:

• -l, --limit <n> Limit number of chunks
• -s, --strict Strict protocol validation

snapshot

Creates a local memory snapshot bundle.

npx tekmemo snapshot --label "pre-refactor"

Options:

• -l, --label <name> Snapshot label (default: "manual")

diff

Compares two memory snapshots by ID or label.

npx tekmemo diff "pre-refactor" "post-refactor"

search

Searches memory files for a query.

npx tekmemo search "database"

Options:

• -e, --regex Treat query as a regular expression

doctor

Diagnoses memory issues and finds missing or corrupt memory files.

npx tekmemo doctor

Options:

• -s, --strict Strict protocol validation

validate

Performs strict protocol validation. Useful for CI pipelines.

npx tekmemo validate

edit

Legacy alias to append a note or core memory text.

npx tekmemo edit note "Added a new endpoint"

Options:

• --allow-secrets Allow content that looks like a secret