Skip to content
Pi Hindsight

Tools and commands

For a generated reference of registered tools, commands, and editable config fields, see Generated surface reference.

Public human commands

Section titled “Public human commands”

Pi Hindsight is TUI-first. Public slash commands:

/hindsight
/hindsight:next-opt-out

/hindsight opens a thin memory hub: status, short guided setup, and emergency actions (mode, next-opt-out, flush, doctor). Day-to-day mission/mental-model/config edits belong to agent tools, not a TUI field farm.
/hindsight:next-opt-out skips automatic retain for the next agent run (also hub key x).

Hub keys

Section titled “Hub keys”
Key Action
g Guided setup (profile, agent use, banks, optional templates + import)
m Session mode: normal / read-only / ignored
x Next-opt-out: skip automatic retain for the next agent run
f Flush retain queue
o Doctor diagnostics report (includes status tones)
n Write .pi/hindsight.json with the selected project bank
d Deployment / connection helpers
i Historical import (dry-run first)
t Apply starter bank template / mental-model set (dry-run first)
a Toggle advanced settings (prefer agent tools for day-to-day edits)
q Close

Day-to-day mission, mental-model, knowledge-page, and config edits: prefer agent control-plane tools (hindsight_status, hindsight_config, hindsight_bank, hindsight_mental_model, hindsight_knowledge); the advanced TUI farm is an escape hatch, not the primary surface.

Agent use and mental models

Section titled “Agent use and mental models”

Config field agentUse is coding (default) or conversation.

  • coding starter sets: pi-coding-project, pi-coding-user
  • conversation starter sets: pi-conversation-project, pi-conversation-user

Legacy id pi-user-preferences still resolves to pi-coding-user.

When mental models exist on active banks and mentalModels.inject is true (default), their content is injected into automatic context alongside recall (ephemeral; not retained). See Starter mental model suggestions. Quality guide: Mission and mental-model quality.

Explicit tools

Section titled “Explicit tools”

Pi exposes memory tools plus an agent control plane for selected banks:

  • hindsight_recall
  • hindsight_retain
  • hindsight_retain_global
  • hindsight_reflect
  • hindsight_status
  • hindsight_scope
  • hindsight_config (allowlisted get/patch; dry-run default on patch; no raw secrets)
  • hindsight_bank
  • hindsight_mental_model — list is metadata-only; use get for full content
  • hindsight_knowledge — tree/search/get + dry-run mutating page/folder ops (knowledge-base client/server required; not auto-injected)
  • hindsight_scope_migrate

Platform-wide bank list/delete and full control-plane browsing stay in the Hindsight web UI. Bundled mental-model templates remain available from the hub (t).

Tool notes:

  • In Pi’s interactive TUI, memory tool outputs share one normalized text renderer and support the normal tool-output expansion toggle (Ctrl+O by default). Short outputs render in the same model without needing to fold; long outputs render as compact previews until expanded.
  • hindsight_recall accepts queryTimestamp plus advanced one-off controls: types, budget, maxTokens (including 0), includeChunks, recallChunksMaxTokens, includeSourceFacts, maxSourceFactsTokens, includeEntities, and trace.
  • hindsight_retain and hindsight_retain_global accept explicit Hindsight retain options: entities, documentId, timestamp (including literal unset), metadata, updateMode, observationScopes, documentTags, and async.
  • hindsight_reflect accepts responseSchema for structured reflection output plus budget, maxTokens (including 0), includeFacts, and includeToolCalls when supported by Hindsight.