Diffinery documentation
The documentation is published at diffinery.com/docs. Its
source is Markdown in this repository, under
apps/diffinery/docs/, and every page is also available as
Markdown at https://diffinery.com/docs/<page>.md and in
llms.txt and llms-full.txt
for AI assistants.
Start here
| Page | Source |
|---|---|
| Quickstart | quickstart.md |
| Concepts | concepts.md |
| Deploy your own Diffinery | self-hosting/ |
| Migrate from GitHub | migrate-from-github.md |
| Connect AI apps (Claude, Claude Code, Codex, Cursor) | connect/ |
By topic
| Topic | What it covers | Source |
|---|---|---|
| Actions | GitHub Actions–compatible CI: workflow syntax, events, runners, caching, artifacts, secrets, environments, OIDC, Docker, and the compatibility list | actions/ |
| Repositories | Git over HTTPS, browsing code, branch protection, push protection, cloning in editors | repositories/ |
| Collaboration | Pull requests, reviews, merge on green, merge queue, issues, releases, checks | collaboration/ |
| Agents | Agent accounts and guardrails, the MCP server, sandboxes, tasks, review, projects, Today | agents/ |
| Packages | The container registry | packages/ |
| Accounts | Passkeys, tokens, organizations, permissions, invitations | accounts/ |
| Security | Security model, push protection, audit log, vulnerability disclosure | security/ |
| Self-hosting | Deploy, configure and operate your own instance on Cloudflare; architecture | self-hosting/ |
| Reference | REST and GraphQL APIs, webhook events, limits | reference/ |
| Guides | Faster CI, moving GitHub Actions workflows, running CI while code stays on GitHub, an AI agent with guardrails | guides/ |
Comparisons
Diffinery vs GitHub,
GitLab,
Gitea and Forgejo,
Bitbucket,
CircleCI,
Buildkite,
Blacksmith and
Depot, with sources, in
apps/diffinery/site/compare/.
Also in this folder
- PREFERENCES.md: product and design conventions for contributors.
- images/: screenshots used in the README.