{"id":29210690,"url":"https://github.com/embarkstudios/octobors","last_synced_at":"2025-07-02T21:07:35.918Z","repository":{"id":41850013,"uuid":"322510393","full_name":"EmbarkStudios/octobors","owner":"EmbarkStudios","description":"Rust program for automerging PRs based on a few rules","archived":false,"fork":false,"pushed_at":"2024-06-05T09:01:24.000Z","size":211,"stargazers_count":40,"open_issues_count":12,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-06-06T10:19:49.755Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EmbarkStudios.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-18T06:33:48.000Z","updated_at":"2024-06-05T09:01:28.000Z","dependencies_parsed_at":"2024-06-05T10:08:39.982Z","dependency_job_id":"e890b891-2cbb-4a8d-ace4-3f49b1ec1fc8","html_url":"https://github.com/EmbarkStudios/octobors","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":"EmbarkStudios/opensource-template","purl":"pkg:github/EmbarkStudios/octobors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Foctobors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Foctobors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Foctobors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Foctobors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EmbarkStudios","download_url":"https://codeload.github.com/EmbarkStudios/octobors/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmbarkStudios%2Foctobors/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263215297,"owners_count":23431895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-02T21:07:35.030Z","updated_at":"2025-07-02T21:07:35.901Z","avatar_url":"https://github.com/EmbarkStudios.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🆙 octobors\n\n[![Embark](https://img.shields.io/badge/embark-open%20source-blueviolet.svg)](https://embark.dev)\n[![Embark](https://img.shields.io/badge/discord-ark-%237289da.svg?logo=discord)](https://discord.gg/dAuKfZS)\n[![dependency status](https://deps.rs/repo/github/EmbarkStudios/octobors/status.svg)](https://deps.rs/repo/github/EmbarkStudios/octobors)\n[![Build status](https://github.com/EmbarkStudios/octobors/workflows/CI/badge.svg)](https://github.com/EmbarkStudios/octobors/actions)\n\nA Rust program for automerging PRs based on a few rules.\n\n## Why?\n\nWe made our own automerge program because we couldn't find an existing solution that did exactly\nwhat we wanted.\n\n1. [Github's auto-merge](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request) relies on branch protection rules, some of which we think are kind of broken (required review count), and some of which we don't want to use for other reasons. You also still have to click a button! The horror!\n1. [Mergify](https://mergify.io/) - External service that we don't want to use for our private repos\n1. [automerge-action](https://github.com/pascalgn/automerge-action) - Only provided part of the functionality we wanted, and still relies too heavily on branch protections.\n\n## Usage\n\n```shell\nexport GITHUB_TOKEN=\"my-github-secret-token\"\noctobors path/to/config.toml\n```\n\nRun the octobors binary, giving it a path to a config file containing the\nrepos you wish to process. A GitHub token with write permission to the repo\nmust be found in the `GITHUB_TOKEN` environment variable.\n\nSee [config/example.toml](config/example.toml) for the configuration that Octobors expects.\n\nWe recommend running this on a periodic schedule every minute using cron,\nKubernetes Cronjobs, or similar. Unfortunately GitHub actions schedules can\nbe delayed by up-to 30 minutes and so are not suitable, at least not unless\nyou are happy to wait a long time for PRs to get merged.\n\n## Alternatives\n\n* [Github auto-merge](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)\n* [Mergify](https://mergify.io/)\n* [automerge-action](https://github.com/pascalgn/automerge-action)\n\n## Contributing\n\n[![Contributor Covenant](https://img.shields.io/badge/contributor%20covenant-v1.4-ff69b4.svg)](../main/CODE_OF_CONDUCT.md)\n\nWe welcome community contributions to this project.\n\nPlease read our [Contributor Guide](CONTRIBUTING.md) for more information on how to get started.\n\n## License\n\nLicensed under either of\n\n* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n\nat your option.\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarkstudios%2Foctobors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fembarkstudios%2Foctobors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembarkstudios%2Foctobors/lists"}