影 @kaged/plugin-memory-hindsight

shadow ops for your [recall]

The ceiling-tier kaged memory plugin — vector-graph-temporal agent memory backed by Hindsight, with retain / recall / reflect tools, auto-retain on idle, and compactor-grade compaction hooks.

what it is

Where @kaged/memory-markdown is the reference floor (plain files, keyword scoring), this is the reference ceiling: memories live in a Hindsight bank with vector, graph, and temporal indexing, and the plugin can synthesize answers from them — not just return raw hits.

• retain — store facts, preferences, decisions in long-term memory
• recall — semantic search with tag filters and a low/mid/high budget
• reflect — synthesized answers ("what do you know about this user?") rather than raw entries
• auto-recall on session start, auto-retain on session idle (full-session upsert or sliding-window chunks)
• compactor role — pre_compact / post_compact hooks preserve context across compaction

quick start

# .kaged/project.yaml
plugins:
  memory:
    package: "@kaged/plugin-memory-hindsight"

Then give the daemon your Hindsight token (operator-local, never committed):

# local.toml
[plugins."@kaged/plugin-memory-hindsight".system_config]
api_token = "..."   # from ui.hindsight.vectorize.io/connect

configuration

Highlights from kaged-plugin.yaml (every field has a sensible default; see the manifest for the full schema and knobs):

| Field | Default | Description | |---|---|---| | api_url | https://api.hindsight.vectorize.io | Hindsight endpoint | | isolation | agent | Per-agent or per-project memory bank | | auto_recall / auto_retain | true | Session-start recall, session-idle retain | | retain_mode | full-session | Upsert one doc per session, or sliding-window chunks | | recall_budget | mid | Server-side search intensity | | dynamic_bank_id | false | Compose bank IDs from agent/project context | | bank_mission | "" | Mission statement steering reflect synthesis |

development

bun install
bun test
bun run typecheck
bun run format      # biome

release

Bump version in package.json and kaged-plugin.yaml, tag v<version>, push the tag. CI verifies the tag matches, runs the suite, and publishes to npm with provenance.

license

MIT © the kaged project

[kaged] · kaged.dev · sanctioned edge, sacred code