Agent Friendly Code

championswimmer/TwoFac

GitHub
https://github.com/championswimmer/TwoFac

2FA Authenticator app that works on mobile, web, desktop, watches and CLI!

  • 2fa
  • 2fa-client
  • 2factor-authentication
  • authenticator
  • authy
  • otp-verification
  • totp-generator
  • two-factor-authentication
Stars:
130
Language:
Kotlin
Default branch:
main
Last scored:
Overall

At a glance

Rank
#306 of 401
#6 of 12 Kotlin repos
Checks passed
7 of 17
Full list below
Best set up for
Codex
Score 65.7
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  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 weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Codex
#267 of 401
65.7
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ✗Test suite
Pi
#268 of 401
62.9
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ✗Linter / formatter config
Kimi Code CLI
#281 of 401
62.5
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ✓Dependency manifest
Claude Code
#313 of 401
60.9
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ~Reproducible dev env
Devin
#298 of 401
60.7
  • ~Reproducible dev env
  • ✓Dependency manifest
  • ✗Test suite
Cursor
#263 of 401
59.2
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration
Gemini CLI
#290 of 401
57.5
  • ✗GEMINI.md
  • ✓README
  • ✗Test suite
OpenHands
#330 of 401
55.0
  • ✓CI configuration
  • ✓Dependency manifest
  • ~Reproducible dev env
Aider
#367 of 401
44.4
  • ✗.aider.conf.yml
  • ✗Linter / formatter config
  • ✗Test suite

Does championswimmer/TwoFac have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
AGENTS.md (new tab) · 3,271 characters
Agent-specific files
.agents/skills (new tab) (8 skills)No GEMINI.md, .cursor/rules, .openhands/setup.sh or .aider.conf.yml
Repos that have one
8 of 12 Kotlin repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 7 passed

Skills (.agents/skills)· 100% pass
8 skills in .agents/skills/
.agents/skills/dependency-updates/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (3,271 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
10 GitHub Actions workflows
.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 (4,141 characters)
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)

How championswimmer/TwoFac compares

vs leaderboard average
8.0 pts below
Average 66.8
vs Kotlin average
0.9 pts above
Average 57.9
Stars among Kotlin repos
#12 of 12

Missing here, and how many repos have it

  • License file · passed by 92% of leaderboard repos, 92% of Kotlin repos
  • CONTRIBUTING guide · passed by 86% of leaderboard repos, 75% of Kotlin repos
  • Linter / formatter config · passed by 65% of leaderboard repos, 8% of Kotlin repos

Passes checks most repos miss

  • Skills (.agents/skills) · only 17% of repos pass it
  • Manageable size · only 16% of repos pass it

One fix for the most agents: Test suite would raise the score for all 9 agents, by up to 14.1 points.

Similar repos

Same language and host as this repo, closest in overall score.

All Kotlin repos →

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

A GitHub Action posts one comment per pull request with how the score changed and why.