Command reference

Local commands for daily memory work.

After a global installer run, use link <command>. From a source checkout, use python3 link.py <command>.

Daily Loop

link serve
link ingest-status
link remember "User prefers feature branches for Link work." --type preference --scope project --project link
link brief "working on Link release" --project link
link query "what should I know before changing the MCP tools?" --budget small --project link
link validate

Memory Commands

link remember

Save a local agent memory. Strong duplicates and likely conflicts are refused unless explicitly allowed.

link recall

Search local memories with recall readiness and project-aware filtering.

link explain-memory

Show provenance, lifecycle, graph links, review issues, and recall readiness.

link update-memory

Merge new text into an existing memory and reset review state.

link archive-memory

Reversibly hide a stale or wrong memory from default recall.

link forget-memory

Permanently delete a memory after explicit confirmation.

Capture Workflow

Use captures for longer chat notes or session summaries that should be reviewed before becoming durable memory.

link capture-session session-notes.md --project link
link capture-inbox --project link
link accept-capture raw/memory-captures/<capture>.md --index 1
link redact-capture raw/memory-captures/<capture>.md
link delete-capture raw/memory-captures/<capture>.md --confirm

Maintenance

link backup
link doctor --fix
link status --validate
link memory-audit
link benchmark "agent memory"
link rebuild-index
link rebuild-backlinks
link validate
link verify-mcp

Use link backup before broad repair work. Use link benchmark when a wiki starts to feel slow.

All Commands

link --version
link init [dir]
link serve [dir] [--port 3000]
link prompts [dir] [--project slug]
link status [--validate]
link backup [--label name] [--include-raw]
link ingest-status
link remember "text" [--project slug]
link propose-memories <file-or-text> [--project slug]
link capture-session <file-or-text> [--project slug]
link capture-inbox [--project slug]
link accept-capture <capture> [--index N]
link redact-capture <capture>
link delete-capture <capture> --confirm
link query "task" [--budget small|medium|large] [--project slug]
link graph-summary ["topic"] [--limit 40] [--depth 1]
link benchmark ["query"] [--budget small|medium|large] [--project slug]
link brief "task" [--project slug]
link memory-audit [--project slug]
link recall "query" [--project slug]
link profile [--project slug]
link memory-inbox [--project slug]
link review-memory <name>
link explain-memory <name>
link update-memory <name> "text" [--project slug]
link archive-memory <name>
link restore-memory <name>
link forget-memory <name> --confirm
link doctor
link doctor --fix
link migrate
link validate [--strict]
link rebuild-index
link rebuild-backlinks
link verify-mcp [--json]
python3 link.py demo
python3 link.py query-link "task" [dir]

query-link is kept as an internal/backward-compatible alias. Prefer link query in user-facing docs.