mirror of
https://github.com/tiennm99/awesome-coding-agents.git
synced 2026-05-19 09:25:53 +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.
# 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