Agent Friendly Code
← back to leaderboard

championswimmer/TwoFacGitHub

https://github.com/championswimmer/TwoFac
Stars:
130
Language:
Kotlin
Default branch:
main
Last scored:
3h ago
Overall

At a glance

Rank
#307 of 372
#3 of 3 Kotlin repos
Checks passed
6 of 16
Full list below
Works best with
GPT-5 Codex
Score 63.9
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

  • AGENTS.md / CLAUDE.md
  • CI configuration
  • Dependency manifest
  • README
  • Manageable size

What it's missing

  • .aider.conf.yml
  • CONTRIBUTING guide
  • Cursor rules (.cursor/rules)
  • GEMINI.md
  • License file

What to fix first

  1. 1
    Test suite
    Add a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.
    +13.2 pts
  2. 2
    Linter / formatter config
    Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
    +7.9 pts
  3. 3
    CONTRIBUTING guide
    Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
    +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.

GPT-5 Codex
63.9
Devin
61.0
Claude Code
60.9
Pi
60.8
Kimi CLI
60.4
Cursor
57.2
Gemini CLI
55.6
OpenHands
53.1
Aider
44.4

Similar repos

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

All checks

AGENTS.md / CLAUDE.md· 100% pass
Substantive (3271 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
10 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
build.gradle.kts
Reproducible dev env· 70% pass
Has gradlew
gradlew
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 0% pass
No LICENSE/COPYING file
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 (4141 chars)
README.md
Manageable size· 100% pass
470 files
Test suite· 0% pass
No test directory or test files found
Type configuration· 100% pass
Typed language (Java/Kotlin)

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/championswimmer/TwoFac
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/championswimmer/TwoFac.svg)](https://agentfriendlycode.com/repo/github/championswimmer/TwoFac)

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?