{"id":50426469,"url":"https://github.com/sidpalas/deputies","last_synced_at":"2026-05-31T11:01:33.913Z","repository":{"id":359140200,"uuid":"1232248372","full_name":"sidpalas/deputies","owner":"sidpalas","description":"Engineering agents for delegated work.","archived":false,"fork":false,"pushed_at":"2026-05-28T03:40:07.000Z","size":3462,"stargazers_count":40,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T04:21:46.021Z","etag":null,"topics":["agents","ai","control-plane","development"],"latest_commit_sha":null,"homepage":"https://deputies.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sidpalas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-07T18:32:43.000Z","updated_at":"2026-05-28T03:59:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sidpalas/deputies","commit_stats":null,"previous_names":["sidpalas/deputies"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sidpalas/deputies","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidpalas%2Fdeputies","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidpalas%2Fdeputies/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidpalas%2Fdeputies/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidpalas%2Fdeputies/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sidpalas","download_url":"https://codeload.github.com/sidpalas/deputies/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidpalas%2Fdeputies/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33728391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["agents","ai","control-plane","development"],"created_at":"2026-05-31T11:01:33.232Z","updated_at":"2026-05-31T11:01:33.902Z","avatar_url":"https://github.com/sidpalas.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deputies\n\nDeputies is a control plane for delegating engineering work to [background agents](https://background-agents.com/). It includes a fully featured web UI where each task gets a persistent session for queueing prompts, following live progress, reviewing diagnostics, inspecting artifacts, and managing callbacks from integrations like Slack, GitHub, or webhooks.\n\n\u003e [!NOTE]\n\u003e Deputies is still early-stage. Expect the system to evolve quickly as real usage exposes needed changes, including occasional breaking changes.\n\n![Deputies primary view](docs/images/deputies-primary-view.png)\n\n## What It Does\n\n- Runs agent work in background sessions with a searchable activity history.\n- Streams progress, tool diagnostics, and final responses into the web UI.\n- Uses [Flue](https://github.com/withastro/flue) under the hood to run and resume agent work.\n- Supports Slack and GitHub integrations for issue, thread, and callback-driven workflows.\n- Supports GitHub OAuth login for browser access control.\n- Works with [Daytona](https://www.daytona.io/) and Docker as sandbox providers, plus fake and unsafe local providers for tests and trusted development.\n- Supports standard LLM API-key configuration and OpenAI Codex/ChatGPT subscriptions.\n- Tracks artifacts, callback deliveries, repositories, sandbox status, and queued messages.\n- Deploys as portable Node, Caddy, Postgres, and optional S3-compatible object storage services.\n\n## Deployment\n\nStart with the provider-agnostic deployment guide:\n\n- `docs/deployment.md`: required services, env vars, integrations, sandbox providers, and operations checklists.\n\nSpecific deployment targets:\n\n- Railway: the public template at `https://railway.com/deploy/deputies-monolith` provisions the app services and supporting infrastructure.\n- Docker Compose: `deploy/docker-compose/` contains local production-style Compose stacks for combined and split API/worker/orchestrator deployments.\n\nMore deployment targets are expected over time. See `deploy/README.md`, `docs/deployment.md`, and target-specific docs for details.\n\n## Local Development\n\nFor contributor setup, see `docs/contributing-local-development.md`. It covers the local Postgres and SeaweedFS baseline, Portless, Docker Compose, real Flue, and local integration testing.\n\n## Project Layout\n\n- `apps/`: independently runnable and deployable applications/services.\n- `apps/control-plane/`: backend control-plane API, event stream, stores, integrations, workers, and sandbox providers.\n- `apps/web/`: React frontend for session management and agent progress review.\n- `apps/www/`: static root-domain website with an embedded public demo build.\n- `packages/`: reusable libraries shared by apps, including the Docker sandbox bridge.\n- `deploy/`: deployment and local runtime configuration.\n- `docs/`: architecture, domain notes, testing strategy, and feature backlog.\n\n## More Docs\n\nStart with `docs/README.md` for deeper project documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidpalas%2Fdeputies","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsidpalas%2Fdeputies","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidpalas%2Fdeputies/lists"}