sivtr-memory

Sivtr Memory

Sivtr is the shared local work memory for this machine.

Use it before asking the user to paste logs, repeat decisions, or restate earlier work.

Core rule:

Search for evidence first. Expand only the smallest relevant context. Ask when memory is missing, ambiguous, stale, or permission is required.

MCP tools (preferred when available)

If the host exposes sivtr MCP tools, prefer them over shelling out to the CLI. Register with:

sivtr mcp install -y

Tool	Use
sivtr_search	Narrow search over terminal / agent / provider / desk:...
sivtr_show	Expand a ref or @last / @name
sivtr_zoom	Neighboring record context
sivtr_filter	Narrow @last or a saved set
sivtr_status	Hooks, providers, daemon, local workspace origins (ws), remotes, vars

Fall back to CLI commands below when MCP is not configured.

When to Use

Use this skill whenever local work memory may contain useful evidence. Sivtr retrieves recent terminal activity, AI conversation history, prior decisions, validation output, debugging trails, and handoff context.

Use it before asking the user to repeat context when you need to know things like:

• what just happened in the terminal or an agent session
• what command was run, what output it produced, or whether validation passed
• what the user or a previous agent decided, rejected, or planned
• where earlier debugging, build, test, lint, deploy, or research work left off
• what evidence supports a recap, handoff, status update, or next step
• whether missing or truncated current-context output exists in local memory

Do not use Sivtr as truth by itself. Treat memory as evidence to retrieve, then verify current files or commands before making claims about current state.

Default Retrieval Workflow

Mental model to keep in mind:

• A WorkSet is records + anchors: records are the materialized backing store; anchors are the active positions moving through search, filter, work, nav, zoom, and show.
• Treat @last and @name as WorkSet variables. Use --save <name> or sivtr var set <name> <source> whenever a result will be reused or refined.
• Use filter to narrow a WorkSet, work parts to project record anchors into part anchors, nav to move anchors deterministically, and zoom only when you want neighboring record context.
• In shell pipelines, @ means "read the WorkSet JSON from stdin". Do not pipe --refs text into @; either omit --refs in intermediate commands or use @last / @name.