- In a Diversion workspace, the agent uses
dv. When the agent runsdv commit, the plugin links the session to the commit. - In a Git repository with continuous sync to Diversion, the agent uses
git. The link appears after you push the commit and Diversion imports it.
Install the plugin
Install or update Diversion. Make sure thatdv is on your PATH. See the Quickstart.
Claude Code
- Start Claude Code from your repository folder.
-
Run these commands inside Claude Code.
-
Run
/quit. Then start Claude Code again from your repository folder.
Codex CLI
-
Run these commands in your terminal.
-
Start
codexfrom your repository folder. If Codex asks you to trust the folder, approve it. -
Run
/hooksin Codex. Review and trust the Diversion hooks. - Restart Codex from your repository folder.
Ask about a commit
Use the command for your agent. You can pass a Diversion commit ID, a Git SHA, a file path, or a question about a change.
The agent uses the linked transcript to explain why the change was made.
Stop recording
Disable or uninstall the plugin on each computer where you use it. The plugin records new sessions while it is active.Claude Code
To stop recording and keep the plugin installed, run/plugin disable diversion@diversion inside Claude Code. To uninstall it, run /plugin uninstall diversion@diversion.
After either command, restart any open Claude Code sessions.
Codex CLI
Runcodex plugin remove diversion@diversion in your terminal to uninstall the plugin. Then restart any open Codex sessions.
Delete your transcripts
If you use a self-hosted installation, contact support to delete your transcripts.1
Open Settings > AI
Open Settings > AI in the Diversion cloud web app. Find Delete Claude Code session transcripts. This control deletes sessions from both Claude Code and Codex.
2
Choose repositories
For all repositories, select All repositories. To delete sessions from a subset, select Specific repositories. Then select up to 10 repositories in Choose repositories.
3
Delete the sessions
Click Delete sessions. In the confirmation dialog, click Delete.
4
Wait for deletion to finish
The page shows the deletion progress. When deletion finishes, the app shows Claude Code sessions deleted.If you see “The deletion stopped before it finished. Try again.”, click Delete sessions again.

