claude-swiftui-plugin
real-world swiftui for claude — grounded in 1,857 shipping macOS apps.
claude writes bad swiftui. not wrong-syntax bad — confidently-stale bad. deprecated modifiers, api shapes that never existed, idioms from wwdc three years ago. the docs tell claude what an api does; they don't tell it how 2026 shipping mac apps actually use it.
this plugin fills that gap. it gives claude a queryable corpus of 1,857 real open-source macOS apps — parsed with swiftsyntax (apple's own compiler parser, not regex), ranked by code quality, and wrapped in a cli that answers one question: how do actual shipping apps write this?
every result carries a github permalink pinned to a commit sha and links to the matching sosumi.ai doc so the spec and the practice are always one hop apart.
on top of the lookup layer sits a complete macOS swiftui audit suite — 29 skill-driven domain auditors, each backed by a 334-rule static lint engine that locates candidates and lets claude judge.
the numbers
| |
|---|
| repos analyzed | 1,857 open-source macOS SwiftUI apps |
| parser | swiftsyntax — exact attributes, modifiers, property wrappers, call shapes; not regex |
| sdk surface | macOS 26.5 .swiftinterface + swift symbolgraph-extract |
| api coverage | 511 modifiers · 402 types · ~120 style values · property wrappers · env keys · 12 whole-pattern recipes |
| audit rules | 334 total (282 ripgrep + 52 ast-grep structural) |
| skills | 33 — 4 write/lookup + 29 audit |
| commands | 4 — /swiftui · /swiftui-review · /swiftui-audit · /swiftui-settings |
| quality ranking | composite score: author authority (aggregate stars) + repo stars + api modernity + recency |
install
/plugin marketplace add yigitkonur/claude-swiftui-plugin
/plugin install swiftui
the cli (swiftui-ctx) auto-installs on first use — downloads a prebuilt universal binary, or builds from source if xcode is available. no manual paths or env setup needed.
audit deps — jq is required to run the audit/lint tier; ast-grep + ripgrep are optional (they unlock the structural lint tier):
brew install jq # required for the audit suite
brew install ast-grep ripgrep # optional — structural + faster grep tiers
without ast-grep/ripgrep the audit suite degrades gracefully to the grep-only tier — it still runs 282 rules, just not the 52 ast-grep structural ones. without jq the audit scripts exit early with a clear message.
cli-only install (no plugin)
git clone https://github.com/yigitkonur/claude-swiftui-plugin
cd claude-swiftui-plugin
make install # downloads/builds swiftui-ctx and symlinks it onto PATH
swiftui-ctx doctor # verify the install
the four commands
/swiftui <api or intent>
look up any swiftui api by name, modifier, property wrapper, or plain english intent. returns the consensus argument shape (ranked by how production apps actually call it), the best real-world example with a github permalink, co-occurring apis, and a link to the sosumi doc.
/swiftui NavigationSplitView
/swiftui @Observable
/swiftui .searchable
/swiftui "drag and drop between lists"
/swiftui frame(width:height:)
/swiftui-review [file]
review a swift file or the current diff for deprecated apis, non-idiomatic patterns, and consensus deviations. produces a prioritized finding list with migration paths and real counterexamples pulled from the corpus.
/swiftui-review ContentView.swift
/swiftui-review # reviews the current diff
/swiftui-audit [directory]
full codebase audit. the orchestrator routes your source tree through the relevant domain auditors in dependency-ordered waves, runs the static lint engine, and rolls everything into _SUMMARY.md with per-finding severity ratings and fix guidance.
/swiftui-audit Sources/
/swiftui-audit .
/swiftui-settings
create or update .claude/swiftui.local.md — per-project plugin configuration. the file is gitignored automatically.
skills
skills fire automatically when you describe a task to claude. the commands above are the explicit entry points when you want to invoke them directly.
write / look up (4 skills)
