Pensieve

Recall validated routines from past coding-agent sessions.

Pensieve is a tiny local routine registry for Claude Code-style workflows. It is not a general memory layer. It stores and retrieves procedural memories: pipelines, checklists, delivery standards, and reusable skills that were validated in previous sessions.

MVP scope

• Local YAML/Markdown routine cards
• SQLite FTS5 index
• High-threshold recall for UserPromptSubmit hooks
• Short additionalContext injection (path + checklist anchor, not full body)
• No vector DB, no Mem0, no automatic transcript extraction yet

Install for development

cd C:\Users\hp\pensieve
python -m pip install -e .

Quick start

Create a routine:

pensieve init
pensieve add examples\fanuc-payload-pipeline.md
pensieve index
pensieve search "之前那个机器人备份提取流程"

Hook-style recall:

pensieve hook "今天提取的数据质量不行，少了哪一步？" --cwd C:\Users\hp

If a high-confidence routine matches, hook prints Claude Code hook JSON containing additionalContext. If not, it prints {}.

Routine card format

A routine card is Markdown with YAML frontmatter:

---
id: fanuc-payload-pipeline
title: FANUC payload extraction pipeline
type: pipeline
status: active
confidence: verified
aliases:
  - 机器人备份提取
  - fanuc payload
trigger_phrases:
  - 之前那个流程
  - 少了哪一步
cwd_hints:
  - C:\Users\hp
checklist:
  - locate sysvars.sv
  - parse PLST_GRP1
  - convert units
---
# FANUC payload extraction pipeline
...

Lifecycle commands

pensieve reject fanuc-payload-pipeline      # mark bad match; excludes from recall
pensieve supersede old-routine --by new-id  # retire an old routine
pensieve stats fanuc-payload-pipeline       # show use/reject counters
pensieve install-hook --dry-run             # preview Claude Code hook config
pensieve install-hook                       # install Claude Code UserPromptSubmit hook
pensieve install-codex-hook                 # install Codex CLI UserPromptSubmit hook

When pensieve hook injects a high-confidence routine, it increments use_count. This is the MVP signal later used by promote-to-skill.

Why not just memory?

Facts are not enough. Pensieve recalls the workflow contract: when to use a routine, what deliverables are expected, and which checklist anchors prevent quality regressions.