Agent Friendly Code

farzaa/clicky

GitHub
https://github.com/farzaa/clicky

The open-source project HeyClicky grew out of. The official HeyClicky app, an AI buddy for Mac and Windows: heyclicky.com

Stars:
7.9k
Language:
Swift
Default branch:
main
Last scored:
Overall

At a glance

Rank
#397 of 401
#10 of 10 Swift repos
Checks passed
4 of 17
Full list below
Best set up for
Claude Code
Score 32.9
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
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +11.8 pts
  3. 3
    Dependency manifest
    Commit a proper manifest (package.json, pyproject.toml, Cargo.toml, go.mod, etc.) plus a lockfile.
    +9.2 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 →

Claude Code
#396 of 401
32.9
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ✗Reproducible dev env
Kimi Code CLI
#395 of 401
32.0
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ✗Dependency manifest
Pi
#395 of 401
32.0
  • ✓AGENTS.md / CLAUDE.md
  • ✗Test suite
  • ✗Linter / formatter config
Codex
#396 of 401
31.6
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ✗Test suite
Cursor
#395 of 401
28.7
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✗Type configuration
Devin
#397 of 401
26.2
  • ✗Reproducible dev env
  • ✗Dependency manifest
  • ✗Test suite
Gemini CLI
#397 of 401
26.1
  • ✗GEMINI.md
  • ✓README
  • ✗Test suite
OpenHands
#400 of 401
23.0
  • ✗CI configuration
  • ✗Dependency manifest
  • ✗Reproducible dev env
Aider
#397 of 401
21.1
  • ✗.aider.conf.yml
  • ✗Linter / formatter config
  • ✗Test suite

Does farzaa/clicky 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) · 13,014 characters
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
3 of 10 Swift repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 4 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (13,014 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 0% pass
No CI config found
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 0% pass
No dependency manifest found
Reproducible dev env· 0% pass
No Makefile / devcontainer / Docker / equivalent found
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 (6,648 characters)
README.md
Manageable size· 100% pass
84 files
Test suite· 0% pass
No test directory or test files found
Type configuration· 0% pass
No type config found

How farzaa/clicky compares

vs leaderboard average
38.6 pts below
Average 66.8
vs Swift average
31.7 pts below
Average 59.9
Stars among Swift repos
#7 of 10

Missing here, and how many repos have it

  • CI configuration · passed by 96% of leaderboard repos, 80% of Swift repos
  • Dependency manifest · passed by 92% of leaderboard repos, 80% of Swift repos
  • CONTRIBUTING guide · passed by 86% of leaderboard repos, 60% of Swift repos

Passes checks most repos miss

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

Check the score on every pull request

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