Skip to content
PensievePensievePensieve

Use Pensieve from a coding agent

Read https://docs.pensievelabs.co/agents.md, then wire Pensieve into this project with a sandbox key.

Paste that into Claude Code, Codex, Cursor or any agent that can read a web page, in the project that makes the decision today. The agent reads the instructions, finds the function that makes the decision, wraps it with capture so every call becomes data for experiments, and tests it against the sandbox.

What the agent reads

Section titled “What the agent reads”
File What it holds
/agents.md Step-by-step instructions for wiring Pensieve into a project, and the rules the agent keeps to
/llms.txt A short summary of Pensieve, with links to the two files below
/llms-full.txt Every page in one file
/llms-small.txt Every page in one file, cut down for small context windows
/openapi.json The API contract: every operation, field and error

What the agent keeps to

Section titled “What the agent keeps to”
  • It never handles a live key. It works with a pk_test_ sandbox key. You set PENSIEVE_API_KEY for production yourself, outside the chat.
  • It changes nothing your users see. It wraps the existing call with capture and leaves the model observing. Your code keeps answering until a version passes its gates.
  • It fails open. If Pensieve can’t be reached, your function answers, as it did before.
  • It asks before it steers. Starting an experiment, or changing a model’s budget or routing, is your call. The agent asks you first.
  • It shows you the diff. The change is a few lines around one function, plus a test.