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 configured hybrid or lexical retrieval.

Save a memory (fact, decision, insight, project update) worth keeping across sessions. Requires exactly one of type or ps=true. On timeout the save may still have committed — palinode_search a distinctive phrase before retrying, or you'll duplicate it.

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

Check Palinode health plus the effective read-only capture/recall pause state, policy provenance, and resolved project scope.

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.

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. A pass that reaches the LLM can run for minutes and may outlast your client's own tool-call timeout; the server finishes it either way and holds a run lock while it does, so a retry returns 409 rather than starting again.

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.

Bring one archived memory back into default recall — the inverse of palinode_archive for every archive path (on-demand, forget request, TTL expiry, consolidation). Flips status back to active, drops superseded_by, records restored_at / restored_from provenance and a history line, and commits. Does not un-strike retraction markers (use palinode_unretract) or re-enable triggers.

Withdraw one preference's mention-level retraction from one memory: un-strikes every ~~…~~ [RETRACTED …] span the pref produced and removes the pref from the file's retracted_prefs record, so a later forget request for the same pref can strike again. Pass the pref phrase as recorded in the file's history sibling. The file's status is never changed.

Take a forget request back. Given the memory that holds the request ('please forget that I…'), restores every memory it archived, un-strikes every mention it retracted, and archives the request record(s) so they stop acting as the retraction. Each step is its own audited commit; failures are reported per target.

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.

Ask what memory holds RIGHT NOW about a question, or about one record. Returns the assertions that stand (with their evidence and source revisions), what replaced what, conflicts with every side intact, and what is explicitly unknown. Use instead of palinode_search when you want the current answer rather than a list of hits. Read-only; a tight budget can shrink the answer but never turns a conflict into a settled one.

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.