# Hindsight Coding Agent

How this machine's Hindsight coding-agent memory works, the plugin behind the 🧠 banner.

- Repository: https://github.com/vectorize-io/hindsight (57678 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vectorize-io/hindsight --skill hindsight-coding-agent -g -a claude-code -y`
Codex: `npx skills add vectorize-io/hindsight --skill hindsight-coding-agent -g -a codex -y`
Cursor: `npx skills add vectorize-io/hindsight --skill hindsight-coding-agent -g -a cursor -y`
Gemini CLI: `npx skills add vectorize-io/hindsight --skill hindsight-coding-agent -g -a gemini-cli -y`

## Description

How this machine's Hindsight coding-agent memory works, the plugin behind the 🧠 banner. Use when the user says "store/remember this in hindsight", asks what the memory/knowledge pages are, wants to configure per-repo memory (disable, rename banks, git depth), or something memory-related looks broken.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- GENERATED from README.md (its skill:begin regions) + skill-src/preamble.md.
     Edit those, then run: npm run skill:build -->

# Hindsight Coding-Agent Memory

This machine runs the `hindsight-coding-agents` plugin: long-term project memory for coding
sessions, backed by a Hindsight server. You (the agent) are already wired into it, this skill
explains what happens automatically, which tools you have, and how to configure or debug it.

## What happens automatically (no action needed)

- **Per-repo memory bank**: each repository resolves to a bank (shown in the session banner:
  `↳ memory bank “coding-agent::<repo>”`). Worktrees share the main repo's bank.
- **Ingestion builds itself**: on first open, the bank is seeded from recent commit messages and a
  read-only codebase survey; every session start, a background engine tops it up (new commits, new
  conversations) and keeps 5 knowledge pages current. There is NO ingest command to run.
- **Session synthesis**: by default, the first prompt of a session triggers one deep memory
  synthesis (`reflect`) injected into context. `autoInject` switches the source: `pages` (knowledge
  page search hits), `recall` (recalled observations), or `none` (nothing injected; the agent
  searches the knowledge pages first and reflects only when they are too shallow).
- **Write-back**: the session transcript is retained into the bank automatically at session end
  (per-turn on opencode). The user never needs to "save" a conversation.

## Storing things deliberately

When the user says "store this in hindsight" / "remember this":

The rest: https://github.com/vectorize-io/hindsight/blob/HEAD/hindsight-integrations/coding-agents/skill/SKILL.md