Hindsight CLI — retain, recall, reflect in the terminal

# Create a profile
hindsight profile create prod \
  --api-url https://api.hindsight.vectorize.io \
  --api-key hsk_...

# List profiles
hindsight profile list

# Inspect a profile
hindsight profile show prod

# Use for a single command
hindsight -p prod bank list

# Make sticky in the current shell
export HINDSIGHT_PROFILE=prod

# Remove a profile
hindsight profile delete prod -y

# Basic
hindsight memory retain <bank_id> "Alice works at Google as a software engineer"

# With context
hindsight memory retain <bank_id> "Bob loves hiking" --context "hobby discussion"

# With a specific event date (ISO 8601)
hindsight memory retain <bank_id> "Project launched" --timestamp 2024-01-15

# Background processing
hindsight memory retain <bank_id> "Meeting notes" --async

# Store without a timestamp
hindsight memory retain <bank_id> "Background fact" --timestamp unset

# Single file
hindsight memory retain-files <bank_id> notes.txt

# Directory (recursive)
hindsight memory retain-files <bank_id> ./documents/

# With context
hindsight memory retain-files <bank_id> meeting-notes.txt --context "team meeting"

# Named retain strategy
hindsight memory retain-files <bank_id> ./documents/ --strategy conversations

# Background processing
hindsight memory retain-files <bank_id> ./data/ --async

# Basic
hindsight memory recall <bank_id> "What does Alice do?"

# With budget and token limit
hindsight memory recall <bank_id> "hiking recommendations" \
  --budget high \
  --max-tokens 8192

# Filter by fact type
hindsight memory recall <bank_id> "query" --fact-type world,observation

# Filter by tags
hindsight memory recall <bank_id> "query" --tags work,project --tags-match all

# Pin results to a specific point in time
hindsight memory recall <bank_id> "query" --query-timestamp "2026-01-15T00:00:00Z"

# Show retrieval trace
hindsight memory recall <bank_id> "query" --trace

# Basic
hindsight memory reflect <bank_id> "What do you know about Alice?"

# With additional context
hindsight memory reflect <bank_id> "Should I learn Python?" --context "career advice"

# Higher budget for complex questions
hindsight memory reflect <bank_id> "Summarize my week" --budget high

# Filter fact types and exclude mental models
hindsight memory reflect <bank_id> "What happened last quarter?" \
  --fact-types world,experience \
  --exclude-mental-models

# View observation history for a memory unit
hindsight memory history <bank_id> <memory_id>

# Remove observations while keeping the core fact
hindsight memory clear-observations <bank_id> <memory_id>
hindsight memory clear-observations <bank_id> <memory_id> -y   # skip prompt

# List all banks
hindsight bank list

# View bank disposition
hindsight bank disposition <bank_id>

# Set disposition and mission
hindsight bank set-disposition <bank_id> --mission "..." --name "..."

# View statistics
hindsight bank stats <bank_id>

# Set bank name
hindsight bank name <bank_id> "My Assistant"

# Set mission
hindsight bank mission <bank_id> "I am a helpful AI assistant"

# Clear all observations across the bank
hindsight bank clear-observations <bank_id>
hindsight bank clear-observations <bank_id> -y   # skip prompt

# Recover from a failed consolidation
hindsight bank consolidation-recover <bank_id>

# List documents in a bank
hindsight document list <bank_id>

# Get document details
hindsight document get <bank_id> <document_id>

# Update document metadata
hindsight document update <bank_id> <document_id> --context "updated context"

# Delete a document and its memories
hindsight document delete <bank_id> <document_id>

# List entities
hindsight entity list <bank_id>

# Get entity details
hindsight entity get <bank_id> <entity_id>

# List operations
hindsight operation list <bank_id>

# Get operation status
hindsight operation get <bank_id> <operation_id>

# Cancel a pending operation
hindsight operation cancel <bank_id> <operation_id>

# Retry a failed operation
hindsight operation retry <bank_id> <operation_id>

# List webhooks
hindsight webhook list <bank_id>

# Create a webhook (defaults to consolidation.completed events)
hindsight webhook create <bank_id> https://example.com/hook

# Create with specific events and HMAC signing secret
hindsight webhook create <bank_id> https://example.com/hook \
  --event-types retain.completed,consolidation.completed \
  --secret my-hmac-secret

# Update a webhook
hindsight webhook update <bank_id> <webhook_id> --url https://new-url.com

# Delete a webhook
hindsight webhook delete <bank_id> <webhook_id>

# View delivery history
hindsight webhook deliveries <bank_id> <webhook_id>

# List audit entries
hindsight audit list <bank_id>

# Filter by action and transport
hindsight audit list <bank_id> --action recall --transport mcp

# Filter by date range
hindsight audit list <bank_id> \
  --start-date "2026-04-01T00:00:00Z" \
  --end-date "2026-04-10T00:00:00Z"

# Pagination
hindsight audit list <bank_id> --limit 50 --offset 100

# Default pretty output
hindsight memory recall <bank_id> "query"

# JSON
hindsight memory recall <bank_id> "query" -o json

# YAML
hindsight memory recall <bank_id> "query" -o yaml

# Launch the web-based Control Plane UI (requires Node.js)
hindsight ui

# Launch the interactive TUI explorer
hindsight explore

# Configure once
hindsight configure --api-url http://localhost:8888

# Store memories
hindsight memory retain demo "Alice works at Google"
hindsight memory retain demo "Bob is a data scientist"
hindsight memory retain demo "Alice and Bob are colleagues"

# Search
hindsight memory recall demo "Who works with Alice?"

# Generate a response
hindsight memory reflect demo "What do you know about the team?"

# Check bank disposition
hindsight bank disposition demo