Agent Friendly Code
← back to leaderboard

chenglou/pretextGitHub

https://github.com/chenglou/pretext
Stars:
50.8k
Language:
TypeScript
Default branch:
main
Last scored:
18h ago
Overall

At a glance

Rank
#197 of 371
#54 of 81 TypeScript repos
Checks passed
8 of 16
Full list below
Best set up for
Cursor
Score 78.2
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

  1. 1
    Linter / formatter config
    Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
    +7.9 pts
  2. 2
    CONTRIBUTING guide
    Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
    +5.3 pts
  3. 3
    Pre-commit / git hooks
    Set up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.
    +5.3 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.

Cursor
78.2
GPT-5 Codex
74.4
Claude Code
72.9
Kimi CLI
72.5
Devin
71.8
Pi
71.7
Gemini CLI
65.3
OpenHands
62.8
Aider
56.3

Similar repos

Scored for Claude Code. Same language and host as this repo, scoring near it.

All TypeScript repos →

All checks

AGENTS.md / CLAUDE.md· 100% pass
Substantive (9032 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
1 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
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 10 scripts
package.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 0% pass
No linter/formatter config found
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (30489 chars)
README.md
Manageable size· 100% pass
203 files
Test suite· 70% pass
Test files detected (harness/bench/bench.test.ts)
harness/bench/bench.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.

Agent friendly score for github/chenglou/pretext
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/chenglou/pretext.svg)](https://agentfriendlycode.com/repo/github/chenglou/pretext)

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@v7
        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?