mirror of
https://github.com/tiennm99/awesome-coding-agents.git
synced 2026-07-16 10:16:43 +00:00
tiennm99
4ccee1420a
Two new short docs unblock new contributors who currently have to read the Go source to figure out the GITHUB_TOKEN requirement and the agents.yml schema: - docs/LOCAL_DEV.md walks through the PAT setup, the local run command, what files the run modifies, and how to revert before opening a PR. - docs/CONTRIBUTING.md documents the agents.yml fields, enumerates the six valid category values, and explains the rename and deprecation policy now that history is keyed canonically. Also add a one-sentence caption under the table in readme.tmpl so the Delta7d column has a definition in the rendered README.
42 lines
1.3 KiB
Cheetah
42 lines
1.3 KiB
Cheetah
# Awesome Coding Agents
|
|
|
|
> Curated ranking of AI agent coding tools, sorted by GitHub stars.
|
|
> Updated daily by GitHub Actions.
|
|
|
|
**Last updated:** {{.UpdatedAt}} · **Tracked:** {{.Total}} repos
|
|
|
|
| # | Repo | Stars | Δ7d | Language | Last push | Description |
|
|
|---|------|------:|----:|----------|-----------|-------------|
|
|
{{- range .Rows }}
|
|
| {{ .Rank }} | [{{ .NameWithOwner }}]({{ .URL }}) | {{ formatStars .Stars }} | {{ formatDelta .Delta7d .HasDelta }} | {{ .Language }} | {{ .PushedAt }} | {{ .Description }} |
|
|
{{- end }}
|
|
|
|
---
|
|
|
|
## How it works
|
|
|
|
1. `data/agents.yml` is the curated source list.
|
|
2. A daily GitHub Actions workflow (`.github/workflows/update.yml`) runs the Go updater.
|
|
3. The updater fetches live repo metadata via the GitHub GraphQL API in one batched query.
|
|
4. Star counts are appended to `data/history.jsonl` for 7-day delta computation.
|
|
5. This `README.md` is regenerated from `templates/readme.tmpl` and committed back to the repo.
|
|
|
|
**Δ7d:** Change in stars over the past 7 days; `—` means fewer than 7 days of history.
|
|
|
|
## Contributing
|
|
|
|
Add an agent to [`data/agents.yml`](data/agents.yml):
|
|
|
|
```yaml
|
|
agents:
|
|
- owner: github-username-or-org
|
|
repo: repository-name
|
|
category: cli # cli | ide | extension | library | research | web
|
|
```
|
|
|
|
Open a PR. The next daily run picks it up automatically.
|
|
|
|
## License
|
|
|
|
Apache-2.0
|