Compare changes
Choose two branches to see what changed or to start a new pull request.
1 file changed+13−18
modifiedREADME.md+13−18View file
| @@ -23,13 +23,24 @@ | ||
| 23 | 23 | |
| 24 | 24 | If Diffinery is useful to you, a star on GitHub helps other people find it. |
| 25 | 25 | |
| 26 | +## Screenshots | |
| 27 | + | |
| 28 | +| Today: what needs you, agents at work and what merged since yesterday | An agent's pull request, reviewed by another agent with an inline finding and a Fix it button | | |
| 29 | +| --- | --- | | |
| 30 | +| [](docs/images/today.png) | [](docs/images/agent-pull-request.png) | | |
| 31 | +| **An agent task: Claude Code turns a goal into a pull request in a sandbox** | **Merge on green: auto-merge on, checks passed, waiting for a person's approval** | | |
| 32 | +| [](docs/images/agent-task.png) | [](docs/images/merge-on-green.png) | | |
| 33 | +| **A repository, with the clone URL and one-click open in VS Code, Cursor, Windsurf and IntelliJ IDEA** | **A workflow run from `.github/workflows/ci.yml`, with a matrix and `needs`** | | |
| 34 | +| [](docs/images/repository.png) | [](docs/images/actions-run.png) | | |
| 35 | + | |
| 36 | +[](docs/images/job-logs-dark.png) | |
| 37 | + | |
| 26 | 38 | ## Contents |
| 27 | 39 | |
| 28 | 40 | - [Who Diffinery is for](#who-diffinery-is-for) |
| 29 | 41 | - [Why Diffinery](#why-diffinery) |
| 30 | 42 | - [Built for AI coding agents](#built-for-ai-coding-agents) |
| 31 | 43 | - [Plugins and integrations](#plugins-and-integrations) |
| 32 | -- [Screenshots](#screenshots) | |
| 33 | 44 | - [Features](#features) |
| 34 | 45 | - [How it compares](#how-it-compares) |
| 35 | 46 | - [Self-host on your own Cloudflare account](#self-host-on-your-own-cloudflare-account) |
| @@ -60,7 +71,7 @@ | ||
| 60 | 71 | |
| 61 | 72 | ## Built for AI coding agents |
| 62 | 73 | |
| 63 | -Every agent feature is opt-in and sits on top of the Git and CI platform, so a team that uses none of them just has a forge. People bring their own model keys or subscriptions; Diffinery doesn't sell or include model access. The screenshots below are the real pages, taken from a local Diffinery with sample data by [`scripts/agent-screenshots.mjs`](apps/diffinery/scripts/agent-screenshots.mjs), which runs a real agent task, agent review and CI run. | |
| 74 | +Every agent feature is opt-in and sits on top of the Git and CI platform, so a team that uses none of them just has a forge. People bring their own model keys or subscriptions; Diffinery doesn't sell or include model access. The [screenshots](#screenshots) are the real pages, taken from a local Diffinery with sample data by [`scripts/agent-screenshots.mjs`](apps/diffinery/scripts/agent-screenshots.mjs), which runs a real agent task, agent review and CI run. | |
| 64 | 75 | |
| 65 | 76 | ### Agent accounts with guardrails |
| 66 | 77 | |
| @@ -83,32 +94,24 @@ | ||
| 83 | 94 | |
| 84 | 95 | To use your **Claude or ChatGPT subscription** instead of an API key, open a [terminal](https://diffinery.com/docs/agents/terminal): a shell in your browser with the repository checked out, where you sign in to Claude Code or Codex with your own plan and can hand it tasks. |
| 85 | 96 | |
| 86 | -[](docs/images/agent-task.png) | |
| 87 | - | |
| 88 | 97 | See [Agent tasks](https://diffinery.com/docs/agents/tasks) and [Terminals](https://diffinery.com/docs/agents/terminal). |
| 89 | 98 | |
| 90 | 99 | ### Agent review on every pull request |
| 91 | 100 | |
| 92 | 101 | One of your agents reviews pull requests for bugs, security issues and logic errors, the way Cursor's Bugbot does. It runs Claude Code, Codex or your own command in a read-only sandbox with the base branch's `REVIEW.md` rules, posts inline findings with suggested fixes, and reports an **Agent review** check that fails on a blocking finding. **Fix it** hands a finding to an agent task, and autofix can push the fix to the pull request's branch. Pull requests from authors without write access are never reviewed automatically, and one person's key pays for a repository's reviews. |
| 93 | 102 | |
| 94 | -[](docs/images/agent-pull-request.png) | |
| 95 | - | |
| 96 | 103 | See [Agent review](https://diffinery.com/docs/agents/review). |
| 97 | 104 | |
| 98 | 105 | ### Today and Needs you |
| 99 | 106 | |
| 100 | 107 | **Today** is the first page after you sign in. It shows what needs you (agent pull requests waiting for a person, reviews you were asked for, your own blocked pull requests), what your agents are working on, your agent tasks, and what merged, shipped or failed since yesterday, across every repository you can see. Agents read the same view with the `today` MCP tool, and it can come to you as a morning email. |
| 101 | 108 | |
| 102 | -[](docs/images/today.png) | |
| 103 | - | |
| 104 | 109 | See [Today](https://diffinery.com/docs/agents/today). |
| 105 | 110 | |
| 106 | 111 | ### Merge on green |
| 107 | 112 | |
| 108 | 113 | Pick the checks that must pass in **Settings → Merge on green**, name the agents whose pull requests should land by themselves, and choose whether they wait for a person's approval. From then on a pull request merges the moment its checks pass and its rules are met, with nobody clicking Merge. Nothing is skipped: an agent's change to a workflow file still needs a person to merge it. |
| 109 | 114 | |
| 110 | -[](docs/images/merge-on-green.png) | |
| 111 | - | |
| 112 | 115 | See [Merge on green automatically](https://diffinery.com/docs/collaboration/merge-on-green). |
| 113 | 116 | |
| 114 | 117 | ### Projects, sandboxes and docs for agents |
| @@ -135,14 +138,6 @@ | ||
| 135 | 138 | |
| 136 | 139 | The plugins' sources are in [`plugins/`](plugins), the extensions' in [`apps/vscode`](apps/vscode) and [`apps/jetbrains`](apps/jetbrains), and the CLI's in [`apps/cli`](apps/cli). Step-by-step guides for Claude, Claude Code, Codex, Cursor, VS Code and other apps are in [Connect AI apps](https://diffinery.com/docs/connect). |
| 137 | 140 | |
| 138 | -## Screenshots | |
| 139 | - | |
| 140 | -| A repository, with the clone URL and one-click open in VS Code, Cursor, Windsurf and IntelliJ IDEA | A workflow run from `.github/workflows/ci.yml`, with a matrix and `needs` | | |
| 141 | -| --- | --- | | |
| 142 | -| [](docs/images/repository.png) | [](docs/images/actions-run.png) | | |
| 143 | - | |
| 144 | -[](docs/images/job-logs-dark.png) | |
| 145 | - | |
| 146 | 141 | ## Features |
| 147 | 142 | |
| 148 | 143 | | Area | What you get | Docs | |