How to use it

AI assistants often sound finished when they are not. They say tests passed, or they only changed one file. The chat cannot prove that.

Traceproof keeps a private log in your project folder. The next time you open the same folder, the assistant reads that log first, not its old story.

Redeem your code at https://ophrodite.vercel.app/redeem. You get a zip. Unzip it.

Claude Code is a plugin (hooks plus instructions). Install the Traceproof plugin, or drop the unzipped folder into Claude Code as a plugin. You should not need to paste paths or edit settings by hand.

ChatGPT uses the same zip as an agent skill: Plugins → Skills → upload the zip. ChatGPT does not get the automatic file logging Claude Code does. The assistant still follows the instructions and can write the log when it runs the included program.

Cursor / Codex: put the unzipped folder in that product's skills directory.

Open the project folder in Claude. Say:

The assistant runs a setup command for you. That creates a .traceproof folder (the log) and a short note so the next chat knows to look there. You should see a line like "Traceproof is on in this folder."

Do this once per project. If you already did it with an older copy, say it again after you update. Setup will clean leftover settings that used to log everything twice.

Then work as usual. You do not run Traceproof yourself.

1. If something looks off, ask: what did the agent actually do?
2. It should open a short report in the project, not invent a recap.
3. Start a new chat in the same folder if you want a clean slate. The log is still there.

The log stays on disk. It is not dumped into the chat, so it barely uses extra tokens.

• Every action is listed twice. Setup used to add extra hooks on top of the plugin. Say "set up Traceproof" again. That removes the extra copy.
• The assistant cannot run a terminal command and mentions hook.py. Say set up Traceproof again.
• Redeem gave the wrong zip. CrowdFlow and Traceproof use different codes. Paste the code at https://ophrodite.vercel.app/redeem. The site picks the right download.
• You are not using the Claude plugin and nothing is logging automatically. Ask the assistant to set up Traceproof with project settings. (Only do that if the plugin is off.)