> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Coding agent plugins

> Install the Diversion plugins for Claude Code and Codex, ask about commits, and manage recorded sessions.

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](https://docs.diversion.dev/quickstart.md).

### Claude Code

1. Start Claude Code from your repository folder.

2. Run these commands inside Claude Code.

   ```text theme={null}
   /plugin marketplace add DiversionCompany/diversion-ai-plugins
   /reload-plugins
   /plugin install diversion@diversion
   ```

3. Run `/quit`. Then start Claude Code again from your repository folder.

### Codex CLI

1. Run these commands in your terminal.

   ```bash theme={null}
   codex plugin marketplace add DiversionCompany/diversion-ai-plugins
   codex plugin add diversion@diversion
   ```

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](https://github.com/DiversionCompany/diversion-ai-plugins#install).

## 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.

| Agent | Example |
| - | - |
| Claude Code | `/diversion:ask dv.commit.12345` |
| Codex | `$diversion:ask dv.commit.12345` |

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.

> [!WARNING]
>
> Deletion is permanent. To prevent new uploads, stop recording before you delete your sessions.

**1. Open Settings > AI**

Open [Settings > AI](https://app.diversion.dev/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.