agentdiff

From source manually (requires Rust 1.85+)

git clone https://github.com/codeprakhar25/agentdiff.git cd agentdiff cargo build --release mkdir -p ~/.local/bin install -m 0755 target/release/agentdiff ~/.local/bin/agentdiff ```

</details>

---

Install

curl -fsSL https://agentdiff.site/install | sh

Requirements: Python 3.7+ on PATH, Git 2.20+, Rust 1.85+ (installed automatically if missing)

<details> <summary>Other install methods</summary>

```bash

Install the local agent guidance skill into this repo

agentdiff install-skill --scope project agentdiff install-skill --scope global # optional personal default

Skip git hook install during init

agentdiff init --no-git-hook

Install project-local guidance so Cursor agents learn this workflow

agentdiff install-skill --scope project ```

agentdiff install-skill --scope project writes .cursor/skills/agentdiff-context/SKILL.md in the current repo. Use --scope global for a personal default, and --force to overwrite an existing skill file.

When used with --post-pr-comment, context reports are filtered to commits on the current PR branch and update the existing AgentDiff comment when possible.

---

One-time setup per developer

agentdiff keys init

Quick Start

```bash

Example Output

agentdiff list

  agentdiff list — 6 entries

  #    COMMIT     TIME          AGENT          MODEL                  FILE(S)                          LINES              TRUST    PROMPT
  ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  1    a1b2c3d4   Apr 14 09:12  claude-code    claude-sonnet-4-6      src/commands/push.rs             1-47               92       "fix ordering: write local ref befor…"
  2    b2c3d4e5   Apr 14 09:44  codex          o4-mini                src/store.rs +2                  112-198, 201-230   —        "add fetch_ref_content helper"
  3    c3d4e5f6   Apr 13 18:01  cursor         cursor-fast            src/cli.rs                       305-381            —        "add status --remote args struct"
  4    d4e5f6a7   Apr 13 17:30  opencode       claude-sonnet-4-6      src/main.rs                      80-94              88       "wire remote_status dispatch"
  5    e5f6a7b8   Apr 12 11:04  windsurf       claude-sonnet-4-6      src/init.rs                      44-68              —        "remove legacy .agentdiff dir creat…"
  6    f6a7b8c9   Apr 11 16:22  human          —                      README.md                        —                  —        —

<details> <summary>agentdiff list flags</summary>

```bash

1. Configure global agent hooks — run once per machine

agentdiff configure

Configure all supported agents directly, including Gemini/Antigravity

agentdiff configure --all

Configure only selected agents without the interactive picker

agentdiff configure --agents cursor,codex,opencode

Skip specific agents during configure

agentdiff configure --no-copilot --no-antigravity

Configuration

Config lives at ~/.agentdiff/config.toml:

schema_version = "1.0"
scripts_dir = "~/.agentdiff/scripts"
capture_prompts = true   # set false to omit prompt excerpts from traces

[[repos]]
path = "/home/user/my-project"
slug = "-home-user-my-project"

```bash

View current config

agentdiff config show ```

---

Write CI workflows to .github/workflows/ (run once per repo)

agentdiff install-ci

Agent Context Workflow

agentdiff can preserve lightweight intent and files-read context so reviewers and local agents can understand why a change was made, not just which lines were attributed.

```bash

CI Integration

Run once to write both workflow files into your repo:

agentdiff install-ci
git add .github/workflows/agentdiff-*.yml
git commit -m "ci: add agentdiff consolidation and policy workflows"

This writes two workflows:

• agentdiff-consolidate.yml — triggers on PR merge: consolidates per-branch traces into the permanent store and posts an attribution comment to the PR.
• agentdiff-policy.yml — triggers on every PR: runs agentdiff policy check and posts GitHub check annotations if rules are violated.

For repos that need a custom pipeline, the manual equivalent:

```yaml

.github/workflows/agentdiff-policy.yml

on: [pull_request] permissions: contents: read checks: write

jobs: agentdiff: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0

- name: Install agentdiff run: | curl -fsSL https://raw.githubusercontent.com/codeprakhar25/agentdiff/main/install.sh | bash echo "$HOME/.local/bin" >> $GITHUB_PATH

- name: Fetch agentdiff refs run: git fetch origin '+refs/agentdiff/:refs/agentdiff/' || true

- name: Verify signatures run: agentdiff verify

- name: Policy check run: agentdiff policy check --format github-annotations ```

---