From 21ad0d47a5f20059f862c23964ff77a6469d04c7 Mon Sep 17 00:00:00 2001 From: tiennm99 Date: Wed, 16 Sep 2026 21:11:54 +0700 Subject: [PATCH] feat: admit agent development environments; add Orca and Paseo Criterion 1 previously excluded "workspaces for agents", which ruled out the ADE category entirely. ADEs are the surface a developer actually works in, the same way a coding agent is, so they now qualify on their own terms. Libraries, SDKs, skill collections and observability-only layers stay out. - Widen inclusion criterion 1 in templates/readme.tmpl and document the two admitted kinds in docs/CONTRIBUTING.md. - Add `orchestration` to the Workflow facet in validate.go so ADEs are filterable as a distinct class on the dashboard. - Add stablyai/orca (70.0k) and getpaseo/paseo (17.5k). README.md is regenerated from the template by the daily run; its Contributing section is updated here so it is not stale in the meantime. go run . -check: 43 agents valid. go test ./...: ok. --- README.md | 4 ++-- data/agents.yml | 8 ++++++++ docs/CONTRIBUTING.md | 18 ++++++++++++++++++ templates/readme.tmpl | 4 ++-- validate.go | 2 +- 5 files changed, 31 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 4919ebb..568150f 100644 --- a/README.md +++ b/README.md @@ -68,7 +68,7 @@ **Inclusion criteria** — a repo belongs on this list when it is: -1. **An AI coding agent or assistant itself** — a tool that autonomously writes, edits, or reviews code. Frameworks, wrappers, observability layers, and workspaces *for* agents are out of scope. +1. **An AI coding agent, or an environment for running them** — either a tool that autonomously writes, edits, or reviews code, or an *agent development environment* (ADE) that runs and coordinates those agents as its primary purpose. Libraries, SDKs, prompt/skill collections, and observability-only layers remain out of scope. 2. **Notable**: roughly **10,000+ GitHub stars** (the current list floor). 3. **Open source and actively maintained** — no push in **6 months** means the entry is dropped. The daily run flags anything past **3 months** for review, so the ranking reflects tools people can actually use today. @@ -89,7 +89,7 @@ agents: |-------|------| | Surface (at least one) | `terminal` · `editor-plugin` · `ide` · `desktop` · `web` · `self-hosted` | | Model access | `byo-model` · `single-vendor` · `local-models` | -| Workflow | `interactive` · `autonomous` · `review` · `app-builder` · `research` | +| Workflow | `interactive` · `autonomous` · `review` · `app-builder` · `research` · `orchestration` | | Integration | `mcp` · `acp` · `headless` | | Origin (at most one) | `vendor` · `community` | diff --git a/data/agents.yml b/data/agents.yml index 811574b..5e586b4 100644 --- a/data/agents.yml +++ b/data/agents.yml @@ -143,3 +143,11 @@ agents: repo: Orkas tags: [desktop, byo-model, interactive, community] notes: "Open-source, local-first desktop AI workforce coordinated by a Commander through one chat; supports local coding-agent workflows." + - owner: stablyai + repo: orca + tags: [desktop, terminal, byo-model, orchestration, headless, community] + notes: "ADE: runs Codex, Claude Code, OpenCode and Pi side-by-side, each in its own git worktree, with a mobile companion app." + - owner: getpaseo + repo: paseo + tags: [desktop, web, terminal, self-hosted, byo-model, orchestration, headless, community] + notes: "ADE: self-hosted daemon that runs Claude Code, Codex, Copilot, OpenCode and Pi on your own machines, driven from desktop, mobile, web or CLI." diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 59c5bb5..3529c9a 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -24,6 +24,23 @@ Optional fields: `notes` (for clarifications or caveats) | `tags` | list | Yes | Tags from the vocabulary below; at least one surface tag, at most one origin tag | | `notes` | string | No | Additional context or disclaimers | +## Scope + +Two kinds of project belong here: + +1. **Coding agents** — they write, edit, or review code themselves. +2. **Agent development environments (ADEs)** — their primary purpose is running and + coordinating those agents: parallel worktrees, session management, remote or mobile + control. Tag these `orchestration`. + +An ADE earns a row because it is the surface a developer actually works in, the same way +a coding agent is. What stays out is anything that only *assists* agents without being a +place you run them: libraries and SDKs, prompt or skill collections, dashboards and +observability-only layers, and single-purpose wrappers around one agent's config. + +The other two criteria in the [README](../README.md#contributing) — roughly 10,000+ stars +and active maintenance — apply to both kinds equally. + ## Tag Vocabulary Tags replaced the old single-select `category` field, because one slot cannot @@ -55,6 +72,7 @@ lives in `tagVocabulary` (`validate.go`) and reaches the dashboard through - **review** — reviews diffs or existing code rather than writing it - **app-builder** — prompt-to-app scaffolding, with preview and deploy - **research** — published as a research artifact or proof of concept +- **orchestration** — runs and coordinates *other* coding agents as its primary purpose (an ADE), rather than editing code itself **Integration** — what it plugs into. diff --git a/templates/readme.tmpl b/templates/readme.tmpl index 680b225..2b1f070 100644 --- a/templates/readme.tmpl +++ b/templates/readme.tmpl @@ -33,7 +33,7 @@ **Inclusion criteria** — a repo belongs on this list when it is: -1. **An AI coding agent or assistant itself** — a tool that autonomously writes, edits, or reviews code. Frameworks, wrappers, observability layers, and workspaces *for* agents are out of scope. +1. **An AI coding agent, or an environment for running them** — either a tool that autonomously writes, edits, or reviews code, or an *agent development environment* (ADE) that runs and coordinates those agents as its primary purpose. Libraries, SDKs, prompt/skill collections, and observability-only layers remain out of scope. 2. **Notable**: roughly **10,000+ GitHub stars** (the current list floor). 3. **Open source and actively maintained** — no push in **6 months** means the entry is dropped. The daily run flags anything past **3 months** for review, so the ranking reflects tools people can actually use today. @@ -54,7 +54,7 @@ agents: |-------|------| | Surface (at least one) | `terminal` · `editor-plugin` · `ide` · `desktop` · `web` · `self-hosted` | | Model access | `byo-model` · `single-vendor` · `local-models` | -| Workflow | `interactive` · `autonomous` · `review` · `app-builder` · `research` | +| Workflow | `interactive` · `autonomous` · `review` · `app-builder` · `research` · `orchestration` | | Integration | `mcp` · `acp` · `headless` | | Origin (at most one) | `vendor` · `community` | diff --git a/validate.go b/validate.go index f25cf74..caf5fe3 100644 --- a/validate.go +++ b/validate.go @@ -32,7 +32,7 @@ var repoPattern = regexp.MustCompile(`^[A-Za-z0-9._-]+$`) var tagVocabulary = []tagFacet{ {ID: facetSurface, Label: "Surface", Tags: []string{"terminal", "editor-plugin", "ide", "desktop", "web", "self-hosted"}}, {ID: facetModel, Label: "Model access", Tags: []string{"byo-model", "single-vendor", "local-models"}}, - {ID: facetWorkflow, Label: "Workflow", Tags: []string{"interactive", "autonomous", "review", "app-builder", "research"}}, + {ID: facetWorkflow, Label: "Workflow", Tags: []string{"interactive", "autonomous", "review", "app-builder", "research", "orchestration"}}, {ID: facetIntegration, Label: "Integration", Tags: []string{"mcp", "acp", "headless"}}, {ID: facetOrigin, Label: "Origin", Tags: []string{"vendor", "community"}}, }