OrcAI.Tool
0.10.6
dotnet tool install --global OrcAI.Tool --version 0.10.6
dotnet new tool-manifest
dotnet tool install --local OrcAI.Tool --version 0.10.6
#tool dotnet:?package=OrcAI.Tool&version=0.10.6
nuke :add-package OrcAI.Tool --version 0.10.6
OrcAI CLI
A CLI tool for orchestrating bulk GitHub work across many repositories. From a single YAML config, OrcAI creates a GitHub Project, opens templated issues in every target repo, and hands them off to whoever (or whatever) does the work — a human teammate, a bot, or an AI agent like GitHub Copilot or OpenCode.
Full docs, features, and examples: github.com/dburriss/orca
Prerequisites
ghCLI installed and onPATHgh auth login(or a PAT/GitHub App — see the CLI reference)
Quick start
# 1. Scaffold a job config + issue template
orcai generate --name "Add AGENTS.md" --org my-github-org --repo repo-one --repo repo-two
# 2. Edit add-agents-md.yml (repos, labels, action) and add-agents-md.md (the task)
# 3. Run it
orcai run add-agents-md.yml
run finds or creates a GitHub Project, creates issues from your template, adds them to the project, and executes the configured action — assign @copilot/anyone, post a comment, or run a command per repo and open a PR with the result (cmd-to-github). A <basename>.lock.json file is written alongside the YAML so re-runs are fast and idempotent.
Commands
| Command | Description |
|---|---|
orcai generate |
Scaffold a YAML job config and stub issue template |
orcai run |
Execute a bulk job (globs, concurrency control, JSON output) |
orcai nudge |
Re-trigger stale issues with no linked PR |
orcai notify |
Post a templated comment to issues and/or PRs |
orcai validate |
Validate YAML config(s) and repo access |
orcai info |
Display the current state of a job |
orcai cleanup |
Tear down everything created by run |
orcai graph |
Render the dependsOn dependency graph |
orcai migrate |
Upgrade a job YAML/lock file to the current schema |
orcai auth pat/app/create-app/switch |
Manage credentials and profiles |
For full flag details, the YAML schema, config file options, and runnable examples, see the CLI reference, config reference, and examples.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.10.6 | 112 | 10/6/2026 |
| 0.10.5 | 215 | 9/7/2026 |
| 0.10.4 | 143 | 9/3/2026 |
| 0.10.3 | 127 | 9/2/2026 |
| 0.10.2 | 116 | 9/2/2026 |
| 0.10.1 | 122 | 9/1/2026 |
| 0.10.0 | 131 | 8/30/2026 |
| 0.9.0 | 125 | 8/30/2026 |
| 0.8.1 | 313 | 6/16/2026 |
| 0.8.0 | 190 | 6/9/2026 |
| 0.7.5-beta6 | 130 | 6/9/2026 |
| 0.7.4-beta5 | 124 | 5/21/2026 |
| 0.7.3-beta4 | 137 | 5/19/2026 |
| 0.7.2-beta3 | 135 | 5/18/2026 |
| 0.7.1-beta2 | 146 | 5/18/2026 |
| 0.7.0-beta1 | 134 | 5/13/2026 |
| 0.6.0 | 189 | 5/7/2026 |
| 0.5.1 | 318 | 3/17/2026 |
| 0.5.0 | 190 | 3/16/2026 |
| 0.4.4 | 194 | 3/16/2026 |
A job using `dependsOn` could get stuck forever. If it ran while its dependency gate was unmet, no repos were eligible but a lock file was still written with an empty `repos` list. Once the gate opened, later runs saw matching YAML/template hashes and no failures, printed "nothing to do", and never created the issues. The lock fast path now also requires every currently eligible repo to be present in the lock's `repos`; otherwise the job re-runs.