README: move Screenshots to the top, with the agent screenshots · Pull request #320

23

24

If Diffinery is useful to you, a star on GitHub helps other people find it.

25

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)

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

71

61

72

## Built for AI coding agents

62

73

64

75

65

76

### Agent accounts with guardrails

66

77

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

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

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

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

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

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

146

141

## Features

147

142

148

143

| Area | What you get | Docs |

codician/diffinerypublic

README: move Screenshots to the top, with the agent screenshots #320

		@@ -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	+\| [![The Today page on Diffinery: counts of what needs you, agent pull requests open, merged since yesterday and failed runs, then the Needs you, Agents at work, Your agent tasks and Since yesterday sections](docs/images/today.png)](docs/images/today.png) \| [![A pull request opened by an agent on Diffinery, with its intent, a link to the task that wrote it, and an agent review with an inline finding, a suggested fix and a Fix it button](docs/images/agent-pull-request.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	+\| [![An agent task on Diffinery: the goal, Claude Code running as the acme-coder agent, its transcript with file edits and test runs, and the pull request it opened](docs/images/agent-task.png)](docs/images/agent-task.png) \| [![The merge box of an agent's pull request on Diffinery, with its required checks passed and auto-merge on, waiting for a person's approval](docs/images/merge-on-green.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	+\| [![A repository's code page on Diffinery](docs/images/repository.png)](docs/images/repository.png) \| [![A GitHub Actions–compatible workflow run on Diffinery](docs/images/actions-run.png)](docs/images/actions-run.png) \|
	35	+
	36	+[![A job's live log on Diffinery, in dark mode](docs/images/job-logs-dark.png)](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		-[![An agent task on Diffinery: the goal, Claude Code running as the acme-coder agent, its transcript with file edits and test runs, and the pull request it opened](docs/images/agent-task.png)](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		-[![A pull request opened by an agent on Diffinery, with its intent, a link to the task that wrote it, and an agent review with an inline finding, a suggested fix and a Fix it button](docs/images/agent-pull-request.png)](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		-[![The Today page on Diffinery: counts of what needs you, agent pull requests open, merged since yesterday and failed runs, then the Needs you, Agents at work, Your agent tasks and Since yesterday sections](docs/images/today.png)](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		-[![The merge box of an agent's pull request on Diffinery, with its required checks passed and auto-merge on, waiting for a person's approval](docs/images/merge-on-green.png)](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		-\| [![A repository's code page on Diffinery](docs/images/repository.png)](docs/images/repository.png) \| [![A GitHub Actions–compatible workflow run on Diffinery](docs/images/actions-run.png)](docs/images/actions-run.png) \|
143		-
144		-[![A job's live log on Diffinery, in dark mode](docs/images/job-logs-dark.png)](docs/images/job-logs-dark.png)
145		-
146	141	## Features
147	142
148	143	\| Area \| What you get \| Docs \|