apple/swift-argument-parser
GitHubStraightforward, type-safe argument parsing for Swift
- cli
- command-line
- flag
- option
- Stars:
- 3.8k
- Language:
- Swift
- Default branch:
- main
- Last scored:
At a glance
- Rank
- #209 of 401
- #3 of 10 Swift repos
- Checks passed
- 9 of 17
- Full list below
- Best set up for
- Aider
- Score 70.4
- Needs most work for
- OpenHands
- Biggest fix: Reproducible dev env (+10.0 pts)
What it has
What it's missing
What to fix first
Showing fixes for Claude Code
- 1AGENTS.md / CLAUDE.mdAdd an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).+13.2 pts
- 2Reproducible dev envAdd a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.+11.8 pts
- 3Pre-commit / git hooksSet 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 weighs the checks by its own docs. Under each score are its top three. How each agent is scored →
Does apple/swift-argument-parser 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
- None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)
- 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 →
Get a starter AGENTS.md
From the files the checks found. Fill in the commands, then commit it at the root.
# AGENTS.md
Guidance for AI coding agents working in apple/swift-argument-parser. Straightforward, type-safe argument parsing for Swift. Written mainly in Swift.
## Where things are
- Dependencies are declared in `Package.swift`.
- Tests live in `Tests`.
- Lint and format rules are configured in `.swift-format`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Follow the conventions in `CONTRIBUTING.md`.
## Commands
<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO
All 17 checks · 9 passed
How apple/swift-argument-parser compares
- vs leaderboard average
- 0.6 pts above
- Average 66.8
- vs Swift average
- 7.5 pts above
- Average 59.9
- Stars among Swift repos
- #8 of 10
Missing here, and how many repos have it
- Pre-commit / git hooks · passed by 29% of leaderboard repos, 0% of Swift repos
- Reproducible dev env · passed by 22% of leaderboard repos, 0% of Swift repos
- Skills (.agents/skills) · passed by 17% of leaderboard repos, 0% of Swift repos
Passes checks most repos miss
- Manageable size · only 16% of repos pass it
One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 13.3 points.
Similar repos
Same language and host as this repo, closest in overall score.
- vapor/vapor81.8Swift · 26.2k ★
- Swift · 24.6k ★
- Swift · 42.4k ★
- apple/swift-nio66.2Swift · 8.5k ★
- Swift · 3k ★
- Swift · 15k ★
Same topics, any language
Repos tagged with the same GitHub topics, most shared first.
- nrwl/nx86.3TypeScript · CLI
- cli/cli84.5Go · CLI
- TypeScript · CLI
- n8n-io/n8n83.6TypeScript · CLI
- QwenLM/qwen-code82.6TypeScript · CLI
- Shopify/cli81.2TypeScript · CLI
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/apple/swift-argument-parser)Check the score on every pull request
A GitHub Action posts one comment per pull request with how the score changed and why.