Skip to main content
The Diversion plugins help Claude Code and Codex use the right version control commands for your workspace. They record your sessions and link each commit the agent makes to the session that produced it.
  • In a Diversion workspace, the agent uses dv. When the agent runs dv 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 that dv is on your PATH. See the Quickstart.

Claude Code

  1. Start Claude Code from your repository folder.
  2. Run these commands inside Claude Code.
  3. Run /quit. Then start Claude Code again from your repository folder.

Codex CLI

  1. Run these commands in your terminal.
  2. Start codex from your repository folder. If Codex asks you to trust the folder, approve it.
  3. Run /hooks in Codex. Review and trust the Diversion hooks.
  4. Restart Codex from your repository folder.
If a plugin update changes the hooks, Codex can ask you to trust them again. For optional permission setup and plugin updates, see the Diversion AI Plugins README.

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

Run codex 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.
Deletion is permanent. To prevent new uploads, stop recording before you delete your sessions.
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.

What gets deleted

The deletion removes your recorded sessions, transcripts, and checkpoints in the selected repositories. It covers sessions your Diversion account recorded on any computer. Commits linked to those sessions lose their transcript links.