Orbi

Description

Orbi is an open-source AI coding agent that turns labeled GitHub Issues into independently reviewed, merged pull requests and tagged releases. GitHub Issues are the only task queue and state store, so delivery history lives entirely in the repository as PRs, comments, and CI runs.

Features

• Issue-driven delivery: Label an Issue ai-ready and Orbi claims it, creates an isolated worktree, and starts implementation and tests.
• Independent code review: A separate review session checks each PR and requests fixes in the same run before merge is allowed.
• Automated scheduling: A systemd (Linux) or launchd (macOS) timer runs a tick every few minutes with no manual polling.
• Fail-fast error handling: Command errors stop the run immediately and label the Issue ai-blocked for a human decision, with no silent fallback.
• Full observability: Every log line and progress comment shares a run ID, so any delivery can be traced end to end.
• Release automation: On request, Orbi runs the release gates and publishes the tag and release notes itself.

Technology Stack

Built in Python (3.14+) and packaged with uv, driven through the GitHub CLI and the GitHub Issues/PR API. Runs as a self-hosted agent scheduled via systemd or launchd, or as a prebuilt Docker image from GHCR or Docker Hub. Licensed under AGPL-3.0, with a Sustainable Use License offered as an alternative.

Requirements

• Python 3.14 or later (installed via uv)
• GitHub CLI 2.94+ with gh auth login completed
• A Linux host with a systemd user session, or macOS with launchd
• A GitHub repository with Issues enabled and the ai-ready label created