Generated surface reference

This reference is generated from the operation catalog and config editing registry.

1.0 support scope

Pi Hindsight 1.0 supports a stable Pi-first Hindsight integration. Core and Pi workflow tools are part of the stable 1.0 contract. Capability-gated tools are supported when the connected Hindsight server exposes the required upstream endpoint or field; unsupported servers should return a clear capability error.

Tool	Scope
hindsight_recall	core 1.0
hindsight_retain	core 1.0
hindsight_retain_global	core 1.0
hindsight_retain_files	capability-gated 1.0
hindsight_retain_receipts	Pi workflow 1.0
hindsight_route_memory	Pi workflow 1.0
hindsight_delete_document	capability-gated 1.0
hindsight_list_documents	capability-gated 1.0
hindsight_get_document	capability-gated 1.0
hindsight_update_document_tags	capability-gated 1.0
hindsight_list_entities	capability-gated 1.0
hindsight_get_entity	capability-gated 1.0
hindsight_regenerate_entity	capability-gated 1.0
hindsight_get_graph	capability-gated 1.0
hindsight_get_entity_graph	capability-gated 1.0
hindsight_list_tags	capability-gated 1.0
hindsight_list_mental_models	capability-gated 1.0
hindsight_get_mental_model	capability-gated 1.0
hindsight_create_mental_model	capability-gated 1.0
hindsight_promote_reflect_query_to_mental_model	capability-gated 1.0
hindsight_update_mental_model	capability-gated 1.0
hindsight_delete_mental_model	capability-gated 1.0
hindsight_get_mental_model_history	capability-gated 1.0
hindsight_refresh_mental_model	capability-gated 1.0
hindsight_trigger_consolidation	capability-gated 1.0
hindsight_recover_consolidation	capability-gated 1.0
hindsight_clear_observations	capability-gated 1.0
hindsight_inspect_retain_queue	Pi workflow 1.0
hindsight_list_operations	capability-gated 1.0
hindsight_cancel_operation	capability-gated 1.0
hindsight_retry_operation	capability-gated 1.0
hindsight_list_memories	capability-gated 1.0
hindsight_get_memory	capability-gated 1.0
hindsight_get_chunk	capability-gated 1.0
hindsight_get_memory_history	capability-gated 1.0
hindsight_delete_memory_observations	capability-gated 1.0
hindsight_configure	Pi workflow 1.0
hindsight_get_bank_config	capability-gated 1.0
hindsight_update_bank_config	capability-gated 1.0
hindsight_get_bank_profile	Pi workflow 1.0
hindsight_update_bank_profile	Pi workflow 1.0
hindsight_update_bank_disposition	Pi workflow 1.0
hindsight_add_bank_background	Pi workflow 1.0
hindsight_reset_bank_config	capability-gated 1.0
hindsight_list_directives	capability-gated 1.0
hindsight_get_directive	capability-gated 1.0
hindsight_create_directive	capability-gated 1.0
hindsight_update_directive	capability-gated 1.0
hindsight_delete_directive	capability-gated 1.0
hindsight_get_bank_template_schema	capability-gated 1.0
hindsight_export_bank_template	capability-gated 1.0
hindsight_import_bank_template	capability-gated 1.0
hindsight_import	Pi workflow 1.0
hindsight_import_seed_content	Pi workflow 1.0
hindsight_import_chat_transcript	Pi workflow 1.0
hindsight_reflect	core 1.0

Deferred or non-goal upstream surfaces

Surface	1.0 status	Rationale
Cross-bank list/create	Deferred	No public list_banks or arbitrary cross-bank create_bank tool in 1.0.
Full-bank deletion	Deferred	No public delete_bank tool in 1.0; selected-bank reset/delete-like repair remains scoped.
Platform bank stats	Deferred	No global get_bank_stats dashboard/tool in 1.0.
Audit logs and webhooks	Non-goal	Platform administration is outside the Pi-first 1.0 memory lifecycle.

Tools

hindsight_recall

Recall raw memories from Hindsight for this project.

Parameter	Type	Required	Description
query	string	yes	Natural language memory query
bank	string	no	Optional bank id. Defaults to project bank.
types	array<world | experience | observation>	no	Optional Hindsight fact types to retrieve.
budget	low | mid | high	no	Optional Hindsight recall budget override for this tool call.
maxTokens	integer	no	Optional Hindsight recall token cap override for this tool call. Use 0 for metadata/source-only recall when supported by Hindsight.
queryTimestamp	string	no	Optional ISO timestamp for time-scoped recall.
includeChunks	boolean	no	Ask Hindsight to include source chunks when supported.
recallChunksMaxTokens	integer	no	Optional token cap for included recall chunks.
includeSourceFacts	boolean	no	Ask Hindsight to include source facts when supported.
maxSourceFactsTokens	integer	no	Optional token cap for included source facts.
includeEntities	boolean	no	Ask Hindsight to include entities when supported.
trace	boolean	no	Ask Hindsight to include recall trace/debug data.
tags	array	no	Additional tag filter.
tagsMatch	any | all | any_strict | all_strict	no
tagGroups	array	no	Compound Hindsight tag_groups filter. AND-ed with the automatic Pi project/user scope filter.

hindsight_retain

Retain explicit raw content in Hindsight. Use for durable facts or decisions.

Parameter	Type	Required	Description
content	string	yes	Raw content to retain, not summary if source content is available.
context	string	yes	Source context for this memory.
bank	string	no	Optional bank id. Defaults to project bank.
tags	array	no
entities	array	no	Optional Hindsight entities to associate with this retained content.
documentId	string	no	Optional Hindsight document ID. Defaults to the existing deterministic explicit retain document ID.
timestamp	string	no	Optional Hindsight timestamp string, including ISO-ish strings or literal unset, passed through as provided.
metadata	object/map	no	Optional caller metadata string map. Reserved provenance keys such as cwd, pi_session_file, source, and retainSource are set by pi-hindsight and cannot be overridden.
updateMode	append | replace	no	Optional Hindsight update mode for this explicit retain call.
observationScopes	per_tag | combined | all_combinations | array<array>	no	Optional Hindsight observation scopes. Use per_tag, combined, all_combinations, or explicit string groups. When provided, overrides configured default observation scopes for this retain call.
documentTags	array	no	Optional Hindsight document_tags for this retained document when supported.
async	boolean	no	Optional Hindsight async extraction flag for this retain call. Defaults to configured retain.async.

hindsight_retain_global

Retain explicit durable user memory in the configured user bank. Use for stable user identity, preferences, and cross-project workflows only.

Parameter	Type	Required	Description
content	string	yes	Raw memory content to retain.
context	string	yes	Why this memory is durable user context.
tags	array	no
entities	array	no	Optional Hindsight entities to associate with this retained content.
documentId	string	no	Optional Hindsight document ID. Defaults to the existing deterministic explicit retain document ID.
timestamp	string	no	Optional Hindsight timestamp string, including ISO-ish strings or literal unset, passed through as provided.
metadata	object/map	no	Optional caller metadata string map. Reserved provenance keys such as cwd, pi_session_file, source, and retainSource are set by pi-hindsight and cannot be overridden.
updateMode	append | replace	no	Optional Hindsight update mode for this explicit retain call.
observationScopes	per_tag | combined | all_combinations | array<array>	no	Optional Hindsight observation scopes. Use per_tag, combined, all_combinations, or explicit string groups. When provided, overrides configured default observation scopes for this retain call.
documentTags	array	no	Optional Hindsight document_tags for this retained document when supported.
async	boolean	no	Optional Hindsight async extraction flag for this retain call. Defaults to configured retain.async.

hindsight_retain_files

Upload local files to Hindsight native file retain. Returns async operation IDs when supported.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
files	array	yes	Files to upload.
context	string	no	Shared file-retain context.
tags	array	no	Shared tags.
metadata	object/map	no	Shared metadata.

hindsight_retain_receipts

List recent explicit retain receipts so exact document IDs can be deleted.

Parameter	Type	Required	Description
limit	number	no	Maximum receipts to return. Defaults to 10.

hindsight_route_memory

Dry-run memory routing against current project/user policy. Does not retain anything.

Parameter	Type	Required	Description
content	string	yes	Candidate memory content to classify.
context	string	no	Optional context for routing.

hindsight_delete_document

Delete a specific Hindsight document and all memories extracted from it. Destructive and irreversible; requires exact bank/document ID and confirm=true. Export or back up the bank first if the document may be needed later.

Parameter	Type	Required	Description
bank	string	yes	Bank ID containing the document.
documentId	string	yes	Exact Hindsight document ID to delete.
confirm	true	yes	Required destructive-action confirmation. Must be true.

hindsight_list_documents

List Hindsight documents for compact inspection with supported filters.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
q	string	no	Optional text query filter.
tags	array	no	Optional tag filter.
tagsMatch	any | all | any_strict | all_strict	no
limit	number	no	Maximum documents to return.
offset	number	no	Pagination offset.

hindsight_get_document

Fetch one Hindsight document by ID for inspection.

Parameter	Type	Required	Description
documentId	string	yes	Exact Hindsight document ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_update_document_tags

Replace document tags for one Hindsight document. Requires confirm=true.

Parameter	Type	Required	Description
documentId	string	yes	Exact Hindsight document ID.
tags	array	yes	Replacement tag set.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required mutation confirmation. Must be true.

hindsight_list_entities

List Hindsight entities for compact inspection.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
limit	number	no	Maximum entities to return.
offset	number	no	Pagination offset.

hindsight_get_entity

Fetch one Hindsight entity by ID.

Parameter	Type	Required	Description
entityId	string	yes	Hindsight entity ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_regenerate_entity

Regenerate observations for one Hindsight entity. Expensive mutation; requires confirm=true.

Parameter	Type	Required	Description
entityId	string	yes	Hindsight entity ID.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required mutation confirmation. Must be true.

hindsight_get_graph

Explore Hindsight graph with supported filters.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
type	world | experience | opinion	no	Optional graph fact type filter. Hindsight supports world, experience, or opinion.
q	string	no	Optional text query filter.
limit	number	no	Maximum graph items to return.
tags	array	no	Optional tag filter.
tagsMatch	any | all | any_strict | all_strict	no
documentId	string	no	Optional document ID filter.
chunkId	string	no	Optional chunk ID filter.

hindsight_get_entity_graph

Fetch Hindsight entity graph summary when server supports it.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
limit	number	no	Maximum graph items to return.
minCount	number	no	Minimum entity count filter.

hindsight_list_tags

List Hindsight tags for compact inspection.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
q	string	no	Optional tag text filter.
source	memories | mental_models	no
limit	number	no	Maximum tags to return.
offset	number	no	Pagination offset.

hindsight_list_mental_models

List Hindsight mental models for a bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
tags	array	no
tagsMatch	any | all | exact	no
detail	metadata | content | full	no
limit	number	no	Maximum mental models to return.
offset	number	no	Pagination offset.

hindsight_get_mental_model

Fetch one Hindsight mental model by ID.

Parameter	Type	Required	Description
mentalModelId	string	yes	Mental model ID.
bank	string	no	Optional bank id. Defaults to project bank.
detail	metadata | content | full	no

hindsight_create_mental_model

Create a Hindsight mental model from a source query.

Parameter	Type	Required	Description
name	string	yes	Mental model name.
sourceQuery	string	yes	Source query used to build the model.
bank	string	no	Optional bank id. Defaults to project bank.
id	string	no	Optional mental model ID.
tags	array	no
maxTokens	number	no	Optional max token budget.

hindsight_promote_reflect_query_to_mental_model

Create a mental model from a useful project or User Bank reflect query.

Parameter	Type	Required	Description
bank	project | global	yes
name	string	yes	Mental model name.
sourceQuery	string	yes	Reflect query to promote.
id	string	no	Optional mental model ID.
tags	array	no
maxTokens	number	no	Optional max token budget.

hindsight_update_mental_model

Update a Hindsight mental model.

Parameter	Type	Required	Description
mentalModelId	string	yes	Mental model ID.
bank	string	no	Optional bank id. Defaults to project bank.
name	string | null	no
sourceQuery	string | null	no
tags	array | null	no
maxTokens	number | null	no

hindsight_delete_mental_model

Delete one Hindsight mental model. Destructive and irreversible; requires confirm=true. Export a bank template first if the model may be needed later.

Parameter	Type	Required	Description
mentalModelId	string	yes	Mental model ID.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation.

hindsight_get_mental_model_history

Fetch Hindsight mental model history.

Parameter	Type	Required	Description
mentalModelId	string	yes	Mental model ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_refresh_mental_model

Refresh a Hindsight mental model and surface operation IDs when returned.

Parameter	Type	Required	Description
mentalModelId	string	yes	Mental model ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_trigger_consolidation

Trigger Hindsight consolidation for a bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_recover_consolidation

Recover failed Hindsight consolidation work for a bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_clear_observations

Clear all observations for one bank. Destructive and irreversible; requires confirm=true. Export or back up the bank first if observations may be needed later.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation.

hindsight_inspect_retain_queue

Inspect local retain queue and dead-letter metadata without returning retained payloads.

Parameter	Type	Required	Description
includeJobs	boolean	no	Include redacted job metadata. Defaults to false.

hindsight_list_operations

List Hindsight async operations for a bank with supported server filters.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
status	string	no	Optional operation status filter.
taskType	string	no	Optional task type filter.
limit	number	no	Maximum operations to return.
offset	number	no	Pagination offset.

hindsight_cancel_operation

Cancel a pending Hindsight async operation. Requires confirm=true.

Parameter	Type	Required	Description
operationId	string	yes	Hindsight operation ID.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation. Must be true.

hindsight_retry_operation

Retry a failed or cancelled Hindsight async operation. Mutates operation state for one bank.

Parameter	Type	Required	Description
operationId	string	yes	Hindsight operation ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_list_memories

List raw Hindsight memory units for inspection.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
type	string	no	Optional memory type filter.
q	string	no	Optional text query filter.
limit	number	no	Maximum memories to return.
offset	number	no	Pagination offset.

hindsight_get_memory

Fetch a raw Hindsight memory unit by ID.

Parameter	Type	Required	Description
memoryId	string	yes	Hindsight memory ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_get_chunk

Fetch a raw Hindsight source chunk by chunk ID.

Parameter	Type	Required	Description
chunkId	string	yes	Hindsight chunk ID.

hindsight_get_memory_history

Fetch Hindsight memory history by memory ID when server supports it.

Parameter	Type	Required	Description
memoryId	string	yes	Hindsight memory ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_delete_memory_observations

Delete observations for one Hindsight memory. Destructive and irreversible for that memory’s observations; requires exact memory ID and confirm=true. Inspect the memory first and back up the bank if needed.

Parameter	Type	Required	Description
memoryId	string	yes	Hindsight memory ID.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation. Must be true.

hindsight_configure

Write project Hindsight config (.pi/hindsight.json), including project bank override.

Parameter	Type	Required	Description
projectBankId	string	no	Project bank ID to use. Defaults to currently selected bank.
baseUrl	string	no	Hindsight base URL, e.g. http://localhost:8888
globalBankId	string	no	Optional user bank ID.
enableGlobalBank	boolean	no	Enable or disable user bank.
enabled	boolean	no	Enable or disable Hindsight extension.
queuePath	string	no	Retain queue path. Defaults to .pi/hindsight/retain-queue.jsonl.

hindsight_get_bank_config

Read resolved Hindsight bank config and override counts for a selected bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_update_bank_config

Patch supported Hindsight bank config override fields using current server/OpenAPI field names. Requires confirm=true.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
updates	object/map	yes	Bank config override fields to patch using current Hindsight field names.
confirm	true	yes	Required admin mutation confirmation. Must be true.

hindsight_get_bank_profile

Read Hindsight bank profile/background/disposition.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_update_bank_profile

Patch supported Hindsight bank profile fields. Requires confirm=true.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
name	string | null	no
mission	string | null	no
background	string | null	no
reflectMission	string | null	no
retainMission	string | null	no
observationsMission	string | null	no
confirm	true	yes	Required admin mutation confirmation. Must be true.

hindsight_update_bank_disposition

Update bank disposition traits. Requires confirm=true.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
skepticism	integer	yes
literalism	integer	yes
empathy	integer	yes
confirm	true	yes	Required admin mutation confirmation. Must be true.

hindsight_add_bank_background

Append bank background. Optional disposition update; requires confirm=true.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
content	string	yes	Background text to append.
updateDisposition	boolean	no	Ask Hindsight to update disposition from background.
confirm	true	yes	Required admin mutation confirmation. Must be true.

hindsight_reset_bank_config

Reset Hindsight bank config overrides for a selected bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation. Must be true.

hindsight_list_directives

List bank-owned Hindsight directives (hard reflect rules).

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
tags	array	no	Optional tag filter.
tagsMatch	any | all | exact	no
activeOnly	boolean	no	Only return active directives.
limit	number	no	Maximum directives to return.
offset	number	no	Pagination offset.

hindsight_get_directive

Get a bank-owned Hindsight directive by ID.

Parameter	Type	Required	Description
directiveId	string	yes	Directive ID.
bank	string	no	Optional bank id. Defaults to project bank.

hindsight_create_directive

Create a bank-owned Hindsight directive (hard reflect rule).

Parameter	Type	Required	Description
name	string	yes	Human-readable directive name.
content	string	yes	Directive text to inject into prompts.
bank	string	no	Optional bank id. Defaults to project bank.
priority	number	no	Higher priority directives are injected first.
isActive	boolean	no	Whether this directive is active.
tags	array	no	Directive tags.

hindsight_update_directive

Update a bank-owned Hindsight directive.

Parameter	Type	Required	Description
directiveId	string	yes	Directive ID.
bank	string	no	Optional bank id. Defaults to project bank.
name	string | null	no	New directive name.
content	string | null	no	New directive text.
priority	number | null	no	New priority.
isActive	boolean | null	no	New active status.
tags	array | null	no	New tags.

hindsight_delete_directive

Delete a bank-owned Hindsight directive. Destructive and irreversible; requires confirm=true. Export a bank template first if the directive may be needed later.

Parameter	Type	Required	Description
directiveId	string	yes	Directive ID.
bank	string	no	Optional bank id. Defaults to project bank.
confirm	true	yes	Required destructive-action confirmation. Must be true.

hindsight_get_bank_template_schema

Fetch the Hindsight bank-template JSON Schema used to validate portable manifests.

Parameter	Type	Required	Description

hindsight_export_bank_template

Export a portable Hindsight bank template manifest for reuse in another project or bank.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
outputFile	string	no	Optional path to save the exported manifest JSON. Relative paths resolve against cwd.

hindsight_import_bank_template

Dry-run or apply a portable Hindsight bank template manifest from a local JSON file or inline JSON.

Parameter	Type	Required	Description
bank	string	no	Optional bank id. Defaults to project bank.
sourceFile	string	no	Local bank template manifest JSON path. Relative paths resolve against cwd.
manifestJson	string	no	Inline bank template manifest JSON.
dryRun	boolean	no	Preview without writing. Defaults to true.
confirmApply	true	no	Required when dryRun is false. Must be true to apply changes.

hindsight_import

Import a historical Pi session JSONL file into Hindsight with deterministic document ID.

Parameter	Type	Required	Description
sessionFile	string	no	Pi session JSONL path. Defaults to current session file.
bank	string	no	Optional bank id. Defaults to project bank.
dryRun	boolean	no	Preview import without writing.
allLeaves	boolean	no	Import or preview all branch leaves.

hindsight_import_seed_content

Import local markdown/text/JSON seed knowledge with deterministic document IDs. Dry-run by default.

Parameter	Type	Required	Description
paths	array	yes	Files or directories to import. Supports .md, .txt, and .json.
bank	string	no	Optional bank id. Defaults to project bank.
dryRun	boolean	no	Preview import without writing. Defaults to true.
tags	array	no	Additional import tags.

hindsight_import_chat_transcript

Import a chat transcript JSONL file into the configured user memory bank. Explicit separate path from Pi session import.

Parameter	Type	Required	Description
sourceFile	string	yes	Chat transcript JSONL path.
bank	string	no	Optional bank id. Defaults to configured user bank.
dryRun	boolean	no	Preview import without writing.

hindsight_reflect

Ask Hindsight to synthesize an answer from memory. Use explicitly, not for default recall.

Parameter	Type	Required	Description
query	string	yes
context	string	no
bank	string	no
budget	low | mid | high	no	Optional Hindsight reflect budget override for this tool call.
maxTokens	integer	no	Optional Hindsight reflect token cap override for this tool call.
responseSchema	object/map	no
includeFacts	boolean	no	Ask Hindsight reflect to include facts when supported.
includeToolCalls	boolean	no	Ask Hindsight reflect to include tool-call trace data when supported.
tags	array	no	Additional tag filter.
tagsMatch	any | all | any_strict | all_strict	no
tagGroups	array	no	Compound Hindsight tag_groups filter. AND-ed with the automatic Pi project/user scope filter.

Commands

Command	Description
/hindsight	Open Hindsight memory TUI.
/hindsight:init	Write .pi/hindsight.json with the currently selected project bank.
/hindsight:import	Import the current Pi session JSONL into Hindsight.
/hindsight:import-current	Import the current Pi session JSONL into Hindsight.
/hindsight:import-file	Import an explicit Pi session JSONL file into Hindsight.
/hindsight:import-project-sessions	Import Pi session JSONL files scoped to the current repo/cwd.
/hindsight:session	Show current Hindsight session memory mode and tags.
/hindsight:mode	Set session memory mode: normal, read-only, or ignored.
/hindsight:next-opt-out	Skip automatic retain for the next agent run in this session.
/hindsight:retain	Enable or disable retain for this session.
/hindsight:tag	Add or remove a Hindsight tag for this session.
/hindsight:last-recall	Show the last opt-in persisted recall snapshot.
/hindsight:recall-cleanup	Scan or prune accidentally persisted Hindsight recall blocks from the current session transcript.
/hindsight:queue	Inspect local retain queue and dead-letter metadata without printing payloads.
/hindsight:flush	Flush queued retain jobs.

Config fields

Field	Tab	Kind	Default	Choices	Advanced	Reset key	Description
enabled	Connection	boolean	enabled		no	enabled	Master switch. When off, automatic recall and retain are skipped.
baseUrl	Connection	text	http://localhost:8888		no	hindsight.baseUrl	Server endpoint used for recall, retain, reflect, and bank setup.
apiKeyEnv	Connection	text	not set		no	hindsight.apiKey	Recommended: environment variable name that contains the API key. Editing writes a safe env SecretRef, not the raw secret.
apiKeyDirect	Connection	text	not set		yes	hindsight.apiKey	Advanced. Writes raw API key only to user/global config. Prefer API key source/env var whenever possible.
timeoutMs	Connection	positive-int	30000 ms		no	hindsight.timeoutMs	Maximum time to wait for Hindsight network calls.
memoryProfile	Banks	select	project-only	project-only, project+global, global-only, recall-only	no	banks.profile	Choose Project Only for strict isolation, Project + User for personal coding, User Only for cross-repo preference memory, or Recall Only to disable automatic retain.
projectBankId	Banks	text	auto-derived		no	banks.project.bankId	Bank used for this repository. Default derives a stable ID from repo identity.
globalBankEnabled	Banks	boolean	disabled		no	banks.global.enabled	Allows cross-project recall from a shared bank.
globalBankId	Banks	text	not set		no	banks.global.bankId	Shared user bank used only when user memory is enabled.
recallEnabled	Recall	boolean	enabled		no	recall.enabled	Looks up memory before answer generation and injects it ephemerally.
recallBudget	Recall	select	mid	low, mid, high	no	recall.budget	Low, mid, or high retrieval effort.
recallMaxTokens	Recall	positive-int	800		no	recall.maxTokens	Maximum memory tokens injected into context.
recallStoreLast	Recall	boolean	disabled		yes	recall.storeLastRecall	Advanced. Writes the latest successful recall snapshot to a local sidecar for /hindsight:last-recall.
recallStoreFailures	Recall	boolean	disabled		yes	recall.storeLastRecallFailures	Advanced. Also records redacted failed recall attempts in the last-recall sidecar. Requires storing last recall snapshots.
retainEnabled	Retain	boolean	enabled		no	retain.enabled	Stores raw structured conversation deltas after turns.
retainAsync	Retain	boolean	enabled		yes	retain.async	Writes retain jobs through durable queue instead of blocking UI.
queuePath	Retain	text	.pi/hindsight/retain-queue.jsonl		yes	retain.queuePath	JSONL retry queue used when Hindsight is unavailable.
globalRetainMode	Retain	select	explicit-only	explicit-only, router	yes	globalRetain.mode	Advanced. explicit-only keeps global writes manual; router enables future high-confidence routing.
importMode	Import	select	curated	curated, raw, forensic	no	import.mode	Curated drops noisy successful tool results from preview metrics; raw keeps current raw branch import behavior; forensic preserves recall blocks too.
importQualityProfile	Import	select	compatible	compatible, strict	no	import.qualityProfile	Compatible preserves current curated behavior; strict drops process/UI-like, oversized, or repeated successful tool output in curated mode.
importBranches	Import	select	current-only	current-only, all-leaves	no	import.includeBranches	Import current branch only, or every leaf branch explicitly.
importToolResults	Import	select	errors-only	errors-only, summary, content	no	import.toolResults	Curated import defaults to errors-only; summary keeps bounded low-noise successful tool output; content keeps allowed full successful tool content.
importToolSummaryMaxChars	Import	positive-int	500		yes	import.toolResultSummaryMaxChars	Maximum characters kept for successful tool summaries in curated imports.
importManifest	Import	text	.pi/hindsight/import-manifest.json		yes	import.manifestPath	Tracks imported sessions so reimports stay deterministic.
importCheckpoint	Import	text	.pi/hindsight/import-checkpoint.json		yes	import.checkpointPath	Tracks import progress so interrupted imports can resume safely.
importReplaceExisting	Import	boolean	enabled		yes	import.replaceExistingImportedDocs	Uses deterministic replace mode for historical reimports instead of appending duplicates.
importResume	Import	boolean	enabled		yes	import.resume	Skips completed import documents when checkpoint content hashes match.
statusStyle	UI	select	text	off, text, emoji, nerdfont	no	status.style	Off, plain text, emoji, or nerdfont symbols.
statusDetail	UI	select	activity	minimal, project, activity, verbose	no	status.detail	How much Hindsight info appears in Pi footer.
statusMaxLength	UI	positive-int	24		no	status.maxLength	Maximum characters used by Hindsight footer status.
statusActivity	UI	boolean	enabled		no	status.showActivity	Displays recall/retain activity in the status line.
notifyStartup	UI	boolean	enabled		no	notifications.startup	Shows selected Hindsight bank when Pi session starts.
notifyRecall	UI	boolean	disabled		no	notifications.recall	Shows a toast when automatic recall runs.
notifyRetain	UI	boolean	disabled		no	notifications.retain	Shows a toast when automatic retain queues memory.