Project Timeline Report
thedotmack/claude-mem
Writes a narrative Journey Into report on a project's whole development history, built from the timeline that claude-mem has recorded.
Long-term memory for the agent via Hindsight. An agent skill from vectorize-io/hindsight.
Install Hindsight Memory
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install vectorize-io/hindsight hindsight-memory --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .claude/skills/hindsight-memory && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .claude/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memoryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install vectorize-io/hindsight hindsight-memory --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .agents/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .agents/skills/hindsight-memory && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .agents/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install vectorize-io/hindsight hindsight-memory --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .cursor/skills/hindsight-memory && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .cursor/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/vectorize-io/hindsight.git --path hindsight-integrations/agent-plugin/skills/hindsight-memory--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install vectorize-io/hindsight hindsight-memory --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .gemini/skills/hindsight-memory && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .gemini/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install vectorize-io/hindsight hindsight-memoryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .github/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .github/skills/hindsight-memory && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .github/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vectorize-io/hindsight --skill hindsight-memory -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install vectorize-io/hindsight hindsight-memory --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/hindsight-integrations/agent-plugin/skills/hindsight-memory .opencode/skills/hindsight-memory && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "hindsight-memory" agent skill from https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/agent-plugin/skills/hindsight-memory into .opencode/skills/hindsight-memory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-memory", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
hindsight-memory- GitHub stars
- 46k
- Token cost
- ~688 tokens
- SKILL.md length
- 318 words
- Files
- 1
- Skills in repo
- 17
- Repo updated
- First seen
- Licence
- MIT
At a glance
Long-term memory for the agent via Hindsight. An agent skill from vectorize-io/hindsight.
- Recall relevant past context before answering
- SKILL.md covers When to recall (read memory), When to retain (write memory), When to reflect (reason over… and Bank scope
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Retain durable facts as you learn them
What it does
Hindsight Memory is an agent skill from vectorize-io/hindsight. Long-term memory for the agent via Hindsight. Use to recall relevant past context before answering, retain durable facts as you learn them, and reflect over accumulated memory for the "why" behind a decision. Load whenever continuity across sessions matters — the user refers to earlier work, states a lasting preference, or asks a question that prior context could answer.
Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Agent memory. The repository describes itself as: Hindsight: Agent Memory That Learns. The licence is MIT.
When your agent uses it
- Recall relevant past context before answering
- Retain durable facts as you learn them
- Reflect over accumulated memory for the why behind a decision
Example prompts
- “/hindsight-memory”
What it can do on your machine
Read from SKILL.md and the folder at commit 9269b88. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Hindsight Memory loads about 688 tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 318 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from vectorize-io/hindsight at commit 9269b88, republished under its MIT licence (© vectorize-io). 318 words, ~688 tokens.
Download SKILL.mdSave it as
.claude/skills/hindsight-memory/SKILL.md (or your agent's skills folder).- name
- hindsight-memory
- description
- Long-term memory for the agent via Hindsight. Use to recall relevant past context before answering, retain durable facts as you learn them, and reflect over accumulated memory for the "why" behind a decision. Load whenever continuity across sessions matters — the user refers to earlier work, states a lasting preference, or asks a question that prior context could answer.
Hindsight long-term memory
This plugin connects the agent to Hindsight, a long-term memory engine. Memory
persists across sessions in a bank (scoped by HINDSIGHT_BANK_ID), so what you
retain now is available to recall in future conversations.
The hindsight MCP server exposes the tools below. Prefer these over guessing from
scratch when the answer might live in past context.
When to recall (read memory)
Call recall at the start of a task, or whenever the user:
- refers to earlier work, a past decision, or "the thing we set up",
- states a preference or constraint that may already be recorded,
- asks a question that accumulated project/user context could answer.
recall(query: "how do we deploy the API and which region")recall runs semantic + keyword + graph + temporal retrieval and returns the most
relevant memories. Ground your answer in what comes back, and say when nothing
relevant was found rather than inventing continuity.
When to retain (write memory)
Call retain when you learn something durable and reusable — worth having in
a future session, not just this one:
- stable user preferences ("prefers pnpm; deploys from
mainonly"), - project facts and decisions ("staging DB is Postgres 16 on Neon"),
- outcomes and gotchas ("the flaky test was a timezone bug, fixed in #482").
retain(content: "The user deploys the API to us-east-1 via GitHub Actions on push to main.")Do not retain transient chatter, secrets, or anything the user asked you to keep out of memory. Retain the fact, not the whole transcript.
When to reflect (reason over memory)
Call reflect when a single recall is too shallow and you need synthesized
reasoning over everything remembered — the why behind a behavior, or a judgment that
weighs many facts together:
reflect(query: "What has repeatedly caused our CI to flake, and what should we standardize?")reflect is slower and disposition-aware; use it deliberately, not for lookups.
Bank scope
All tools operate on the bank selected by the connection (HINDSIGHT_BANK_ID, default
default). One bank = one memory store — keep a project's or a user's memory in its
own bank so context stays isolated and relevant. You never pass a bank id to a tool;
it is implicit from the endpoint.
© vectorize-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in hindsight-integrations/agent-plugin/skills/hindsight-memory of vectorize-io/hindsight.
Open the folder on GitHubat commit 9269b88
Compare with similar skills
Hindsight Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Hindsight Memory this skillvectorize-io/hindsight | 46k | — | ~688 | Automated safety check: Pass | MIT | |
| Project Timeline Reportthedotmack/claude-mem | 97k | 1 repos | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills | 21k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Beads Task Memorygastownhall/beads | 28k | — | ~1.2k | Automated safety check: Pass | MIT | |
| MemPalace Memory SearchMemPalace/mempalace | 59k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Reflect on Session Learningscursor/plugins | 10k | 5 repos | ~1.2k | Automated safety check: Pass | None |
Similar skills
Neat-Freak Knowledge Closeout
KKKKhazix/khazix-skills
Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.
Beads Task Memory
gastownhall/beads
Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.
MemPalace Memory Search
MemPalace/mempalace
Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.
- Official
Reflect on Session Learnings
cursor/plugins
Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.
Compound Learning Writer
EveryInc/compound-engineering-plugin
Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.
More from vectorize-io/hindsight
All 17 skills in this repoHindsight Docs
vectorize-io/hindsight
Complete Hindsight documentation for AI agents. An agent skill from vectorize-io/hindsight.
Create Agent
vectorize-io/hindsight
Create a new Hindsight-powered subagent with long-term memory.
Figure
vectorize-io/hindsight
Draw an animated figure (boxes, arrows, moving data) as one self-contained SVG for a GitHub README, PR, issue or blog post.
Hindsight Local
vectorize-io/hindsight
Store user preferences, learnings from tasks, and procedure outcomes.
Hs Release
vectorize-io/hindsight
Cut a core Hindsight release (vX.Y.Z) and open the changelog + blog PR.
Ship It
vectorize-io/hindsight
Take a PR from review to merged — run the repo's code-review skill on it in a loop (review, fix, re-review) until nothing is left to fix, applying ALL fixes on the PR branch, wait for CI green, then…
Related
Categories
Questions about Hindsight Memory
What does Hindsight Memory do?
Long-term memory for the agent via Hindsight. An agent skill from vectorize-io/hindsight. Hindsight Memory is an agent skill from vectorize-io/hindsight. Long-term memory for the agent via Hindsight.
When should I use Hindsight Memory?
Hindsight Memory fits situations like: recall relevant past context before answering; retain durable facts as you learn them; reflect over accumulated memory for the why behind a decision.
How do I install Hindsight Memory in Claude Code?
Run `npx skills add vectorize-io/hindsight --skill hindsight-memory -a claude-code`. Or copy the skill folder (hindsight-integrations/agent-plugin/skills/hindsight-memory in vectorize-io/hindsight) into .claude/skills/hindsight-memory in your project. Claude Code loads it when a task matches its description.
How do I install Hindsight Memory in Codex?
Run `npx skills add vectorize-io/hindsight --skill hindsight-memory -a codex`. Or copy the skill folder (hindsight-integrations/agent-plugin/skills/hindsight-memory in vectorize-io/hindsight) into .agents/skills/hindsight-memory in your project. Codex loads it when a task matches its description.
Can I use Hindsight Memory in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vectorize-io/hindsight --skill hindsight-memory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hindsight-memory, .gemini/skills/hindsight-memory, .github/skills/hindsight-memory and .opencode/skills/hindsight-memory in your project.
What does Hindsight Memory need to run?
SKILL.md names no scripts, command-line tools or credentials: Hindsight Memory is instructions for the agent only.
Does Hindsight Memory access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Hindsight Memory safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Hindsight Memory use?
Hindsight Memory is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Hindsight Memory use?
About 688 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Hindsight Memory?
Skills that share tags, products or a category with Hindsight Memory: Project Timeline Report (thedotmack/claude-mem, 97k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Hindsight Memory?
vectorize-io (a GitHub organization) maintains it in vectorize-io/hindsight, which has 46,453 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.
Source: vectorize-io/hindsight on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.