78.1
Overall
At a glance
- Rank
- #102 of 372
- Top 27% · #27 of 82 TypeScript repos
- Checks passed
- 11 of 16
- Full list below
- Works best with
- Cursor
- Score 81.8
- Needs most work for
- Aider
- Biggest fix: Linter / formatter config (+14.1 pts)
What it has
- AGENTS.md / CLAUDE.md
- .aider.conf.yml
- CI configuration
- CONTRIBUTING guide
- Cursor rules (.cursor/rules)
What it's missing
- Linter / formatter config
- Pre-commit / git hooks
What to fix first
- 1Linter / formatter configConfigure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.+7.9 pts
- 2Pre-commit / git hooksSet up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.+5.3 pts
- 3Reproducible dev envAdd a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.+4.7 pts
Score for each AI agent
Each agent looks for different things in a repo, based on its own docs. Under each score are the three checks it cares about most.
Similar repos
Scored for Claude Code. A simple first version: picked only because they share this repo's language and host.
- TypeScript · 115 ★
- TypeScript · 2 ★
- getnao/nao92.8TypeScript · 1.7k ★
All checks
AGENTS.md / CLAUDE.md· 100% pass
Substantive (73892 chars)
AGENTS.md
.aider.conf.yml· 100% pass
Aider config present
.aider.conf.yml
CI configuration· 100% pass
4 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 100% pass
1 .mdc file in .cursor/rules/
.cursor/rules/agents.mdc
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 60% pass
package.json has 11 scripts
package.json
GEMINI.md· 50% pass
GEMINI.md exists (90 chars) — thin
GEMINI.md
License file· 100% pass
License present
LICENSE
Linter / formatter config· 0% pass
No linter/formatter config found
.openhands/setup.sh· 100% pass
Setup script present (1625 chars)
.openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (20140 chars)
README.md
Manageable size· 100% pass
363 files
Test suite· 70% pass
Test files detected (src/agent/agent.test.ts)
src/agent/agent.test.ts
Type configuration· 100% pass
Type config present
tsconfig.json
Add a badge to your README
Paste this at the top of the README. It shows the score, and links back to this page.
[](https://agentfriendlycode.com/repo/github/hsnice16/tula)Check the score on every pull request
Add this file to your repo. On each pull request, it posts one comment showing how the score changed and why. It runs in your own CI, with no outside server involved.
# .github/workflows/agent-friendly.yml
name: Agent-friendly score diff
on:
pull_request:
branches: [main]
permissions:
contents: read
pull-requests: write
jobs:
score-diff:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: hsnice16/agent-friendly-action@v0
with:
agents-badge-token: ${{ secrets.AGENTS_BADGE_TOKEN }}Add AGENTS_BADGE_TOKENto the repo's secrets to turn the comment on. Without it, the action does nothing. Where do I add it?