Session-start context: call this FIRST in a new conversation. Returns the resolved project scope with recent session snapshots, core memories, recent decisions, and open action items as a bounded digest.

List memory files, optionally filtered by category or core status. Use to browse what memories exist before reading or searching.

Read the full contents of a memory file. Use after palinode_list or palinode_search to see the complete content of a specific file.

Search Palinode memory for relevant context about people, projects, decisions, insights, or research. Returns the most relevant memory file excerpts ranked by semantic similarity.

Save a memory to Palinode. Use for important facts, decisions, insights, or project updates worth remembering across sessions. Provide either type (one of the enum values) or ps=true for the ProjectSnapshot shortcut — exactly one is required. If this call times out, the save may still have committed server-side: call palinode_search with a distinctive phrase from your content to confirm before retrying, so you don't create a duplicate entry.

Fetch a URL and save it as a research reference in Palinode memory.

Check Palinode health: API reachability, index stats, last watcher run.

Show the change history of a memory file. Tracks renames (--follow) and includes diff stats per commit. Use detail='full' for the commit-level evolution view (previously palinode_timeline).

Deprecated: use palinode_history with detail='full' instead. Shows commit-level evolution of a memory file including unified diffs per commit.

List all known entities, or get memory files referencing a specific entity.

Run a manual knowledge consolidation pass. Set dry_run=true to preview the proposed operations without applying them.

Archive ephemeral memories whose expires_at has passed (ADR-015 §2.3 TTL regime). Deterministic + idempotent — flips expired memories to status: archived so they drop out of default recall while staying on disk. Set dry_run=true to preview.

Retire one specific memory that is wrong or obsolete. Sets status: archived so it leaves default recall, records the reason in the file's history sibling, and commits — never hard-deletes, so the content stays auditable. Pass superseded_by to name the memory that replaces it (a SUPERSEDE rather than a plain archive). Use this instead of re-saving a memory with a hand-written tombstone body: that leaves the wrong content live in search.

Show what memories changed recently. Use to review what was learned, decisions made, or facts updated in the last N days.

Trace a fact back to when it was first recorded. Shows which session or commit created each line in a memory file.

Compose the full provenance lineage of a memory file into one view: source citations, when it was first saved and last changed, the supersession trail, typed contradiction/evidence links, and how often it has been recalled. Rows whose provenance is not yet captured render an honest placeholder. Read-only.

Revert a memory file to a previous version. Safe: creates a new commit preserving the old version in history. Defaults to dry run.

Sync memory changes to GitHub for backup and cross-machine access.

Register or manage a prospective trigger for Palinode. When a future user message semantically matches the description, the specified memory file will be automatically injected.

Call at the end of a coding or chat session to capture key outcomes to persistent memory. Writes a session summary to today's daily notes and appends status to relevant project files. Provide a brief summary of what was accomplished, decisions made, and any blockers.

Scan memory for health issues: orphaned files, stale active files (>90 days), missing frontmatter fields, and potential contradictions. Returns a report without modifying files.

Advisory project-memory review. Composes the deterministic health signals (stale files, long-unresolved open questions, open contradictions, orphans, missing descriptions, wiki drift) scoped to a project, and proposes corrective ops (PROPOSE_ARCHIVE/UPDATE/SUPERSEDE). Read-only — proposes, never applies. Omit project to review the whole store.

Given draft memory content the LLM is about to save, return the top-K existing memory files whose embeddings are semantically near it. Use BEFORE writing a new memory to decide 'create new' vs 'update existing'. Each result includes a strong_dup flag — when true (similarity ≥ 0.90), the existing file is a near-paraphrase and the LLM should usually update rather than create. Preprocessing strips wikilink syntax and the auto-generated ## See also footer so notes linking the same entities don't false-positive as duplicates.

Given a [[wikilink]] whose target file does not exist, return existing memory files semantically near the link target text. Use during wiki-maintenance passes to either propose a redirect (rename the link to point at an existing file) or to create the missing target file with informed context about its semantic neighbours. Accepts either [[name]] or bare name.

Given a memory file path, find the top-K semantically related files that are NOT currently linked to or from it (no existing [[wikilink]] in either direction). Use during wiki-maintenance passes to surface implicit relationships that no wikilink yet captures — the LLM can then propose new cross-links. Preprocessing strips wikilink syntax and the auto-generated ## See also footer so notes linking the same entities don't false-positive as related.

Given a topic phrase (not a file), check whether any wiki page already covers it. Returns {covered: bool, best_match: str | null, similarity: float}. Use BEFORE ingesting new content to ask 'is this already covered?'. Different framing from palinode_dedup_suggest: takes a short topic phrase rather than full draft content, and answers the binary 'already covered?' question.

Fast palinode health check (<500ms). Skips network probes and canary writes. Checks path integrity, config consistency, and env-var drift. Use this first; call palinode_doctor_deep when results are unclear.

Full palinode health check including network probes and canary write tests. Takes 10-15s. Use when palinode_doctor reports unclear results or you need to verify the API, watcher, and service connectivity.

List, read, or activate versioned LLM prompts stored as memory files in the prompts/ directory. Use 'list' to browse available prompts, 'read' to view a specific prompt's content, or 'activate' to set a prompt version as active (deactivates others of the same task).

Return the dependency tree for a milestone or task slug, or list all unblocked items. Reads depends_on / blocks / parallel_with frontmatter from ProjectSnapshot files. Set unblocked=true to answer 'what can I work on right now?' across all slugs.