Orchestrates Claude Code sessions, one per GitHub issue, with a dashboard.
- Agent (
src/OssOrchestrator.Agent): runs locally. Wakes when GitHub reports a change (and polls every 10 minutes as a safety net), launches Claude sessions, watches PRs and CI, closes finished sessions, and reads commands from the queue. Claude sessions have to run on the machine that has the repos. - Web (
src/OssOrchestrator.Web): ASP.NET Core + Blazor dashboard. Shows sessions, questions and PR status, and sends commands (pause, answer, limit). It has no GitHub credentials. - Queue: Azure Storage Queue (web to agent commands, agent to web state).
- Database: Azure Cosmos DB free tier. Containers:
config,commands,state,events. - Webhook: GitHub calls
POST /webhooks/githubon the web app. It checks the signature and records the event inevents. The agent reads that container through the change feed and runs a pass right away. The pass reads the real state from GitHub, so the event only says "look now".
- The web app runs on Azure App Service (F1) with App Service Authentication (Microsoft Entra ID). Only the owner's account is allowed. Every route requires login.
- The agent authenticates to the queue and the API with a dedicated identity whose secret lives only on the local machine.
- Create the
eventscontainer in databaseorc: partition key/repo, default TTL 7 days (az cosmosdb sql container create -a <account> -g <group> -d orc -n events -p /repo --ttl 604800). The web app identity needs the Data Contributor role on the account; if it has that at account scope, nothing more is needed. - Login is handled inside the app (App Service Authentication is off), and
/webhooks/githubis anonymous: it checks the HMAC signature itself. If you ever turn App Service Authentication on, exclude that path, because GitHub cannot sign in. - Set the app setting
GitHub__WebhookSecretto a long random value. - Register the hook on each repo:
GITHUB_WEBHOOK_SECRET=... scripts/register-webhooks.sh https://<app>.azurewebsites.net owner/repo ...
Scaffold only. Targets .NET 10 until the .NET 11 SDK is available.