diffinery/ROADMAP.md
| 1 | # Roadmap |
| 2 | |
| 3 | Diffinery is young. This page lists what it can't do yet and the directions we'd like to |
| 4 | take, so you can judge whether it fits you today and where help is most welcome. Nothing |
| 5 | here has a date. If something matters to you, open an issue or a pull request. |
| 6 | |
| 7 | ## Works today |
| 8 | |
| 9 | Git hosting over HTTPS, pull requests with reviews, auto-merge and a merge queue, issues, |
| 10 | releases, a container registry, GitHub Actions–compatible CI on per-job Cloudflare |
| 11 | Containers with automatic runner sizing, self-hosted runners, a GitHub importer, the |
| 12 | GitHub-compatible REST and GraphQL APIs, an MCP server, agent accounts with guardrails, |
| 13 | sandboxes, agent tasks and agent review, the CLI, editor plugins and one-command |
| 14 | deployment to your own Cloudflare account. See [Features](https://diffinery.com/features). |
| 15 | |
| 16 | ## Known gaps |
| 17 | |
| 18 | These are the main differences from GitHub that people ask about: |
| 19 | |
| 20 | - **Hosted macOS, Windows and Arm runners.** Hosted runners are Linux x64; other platforms |
| 21 | use [self-hosted runners](https://diffinery.com/docs/actions/runners#self-hosted-runners). |
| 22 | - **Git over SSH.** Git works over HTTPS only. |
| 23 | - **Forks**, and pull requests between repositories. |
| 24 | - **Richer reviews:** pending reviews, suggested changes and resolving threads; code-owner |
| 25 | reviews and signed-commit requirements in branch protection. |
| 26 | - **Workflow events** that are accepted but don't start runs yet, such as `issues` and |
| 27 | `issue_comment`. See [Compatibility](https://diffinery.com/docs/actions/compatibility). |
| 28 | - **Importing from Gitea, Forgejo and GitLab.** The importer reads from GitHub; other forges |
| 29 | move with [plain Git](https://diffinery.com/docs/migrate-from-github#move-with-plain-git). |
| 30 | - **Wikis, discussions and Pages-style static sites.** |
| 31 | |
| 32 | ## Good places to start contributing |
| 33 | |
| 34 | - Compatibility gaps listed in |
| 35 | [Compatibility with GitHub Actions](https://diffinery.com/docs/actions/compatibility): |
| 36 | each one comes with the GitHub behaviour to match. |
| 37 | - Documentation: corrections, missing examples and guides for moving from other CI systems. |
| 38 | - Issues labelled `good first issue` and `help wanted`. |
| 39 | |
| 40 | See [CONTRIBUTING.md](CONTRIBUTING.md) for how to build, test and send changes, and |
| 41 | [CHANGELOG.md](CHANGELOG.md) for what has shipped. |