fleet-memory/hindsight-embed

hindsight-embed

Hindsight embedded CLI - local memory operations without a server.

This package provides a simple CLI for storing and recalling memories using Hindsight's memory engine with an embedded PostgreSQL database (pg0). No external server or database setup required.

Installation

pip install hindsight-embed
# or with uvx (no install needed)
uvx hindsight-embed --help

Quick Start

# Set your LLM API key
export OPENAI_API_KEY=sk-...

# Store a memory
hindsight-embed retain "User prefers dark mode"

# Recall memories
hindsight-embed recall "What are user preferences?"

Commands

retain

Store a memory:

hindsight-embed retain "User prefers dark mode"
hindsight-embed retain "Meeting on Monday" --context work

recall

Search memories:

hindsight-embed recall "user preferences"
hindsight-embed recall "upcoming events" --budget high
hindsight-embed recall "project details" -v  # verbose output

Environment Variables

Variable	Description	Default
HINDSIGHT_EMBED_LLM_API_KEY	LLM API key (or use OPENAI_API_KEY)	Required
HINDSIGHT_EMBED_LLM_PROVIDER	LLM provider (openai, anthropic, google, ollama)	openai
HINDSIGHT_EMBED_LLM_MODEL	LLM model	gpt-4o-mini
HINDSIGHT_EMBED_BANK_ID	Memory bank ID	default

Use with AI Coding Assistants

This CLI is designed to work with AI coding assistants like Claude Code, OpenCode, and Codex CLI. Install the Hindsight skill:

curl -fsSL https://hindsight.vectorize.io/get-skill | bash

This will configure the LLM provider and install the skill to your assistant's skills directory.

License

Apache 2.0