convez.ai
MCP ServerProdutividadeIntermediário
ashokvadivelu

Claude Code iOS Pro

ashokvadivelu/claude-code-ios-pro

Setup completo de Claude Code para iOS com agentes, hooks e comandos pré-configurados

Ver no GitHub
InicialPluginScore · de 0 a 100

Um MCP server production-ready que fornece agentes especializados, comandos slash, hooks de ciclo de vida e templates CLAUDE.md para desenvolvedores iOS sênior. Inclui 8 subagentes, 7 comandos, 6 hooks e conectores MCP curados, instalável em um comando com suporte a Swift 6 e SwiftUI.

Instalação

$npx convez-ai ashokvadivelu/claude-code-ios-pro

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Configurar ambiente de desenvolvimento iOS com agentes especializados em arquitetura e segurança
  • Automatizar code review, testes e auditoria de segurança com slash commands
  • Onboarding de equipes com templates CLAUDE.md reutilizáveis e configs compartilhadas
  • Escalonar projetos iOS com hooks de proteção e validação de builds

Veredito

Solução sólida e bem-pensada para times iOS que usam Claude Code em produção. A abordagem opinionada (Swift 6, MVVM, Swift Testing) poupa decisões arquiteturais, mas exige alinhamento com a equipe sobre essas escolhas padrão.

README

A tradução para o português deste README ainda está na fila.

Claude Code iOS Pro

A production-grade Claude Code setup for senior iOS developers — agents, hooks, skills, commands, MCP connectors and team-shareable CLAUDE.md templates. Install in one command.

License: MIT Claude Code Swift 6 Platform

This is the setup I wish I'd had on day one with Claude Code on an iOS project. It bundles eight specialised subagents, seven slash commands, six lifecycle hooks, a curated MCP connector list, and copy-ready CLAUDE.md templates for the global, project, and local scopes.

It's opinionated but generic: Swift 6 + SwiftUI first, MVVM with @Observable as the default architecture (overridable per-project), Swift Testing over XCTest, security-first defaults aligned to OWASP MASVS. Works for hobby apps, side projects, and production codebases.


What's inside

ComponentCountWhat it does
Subagents8Architecture, code review, SwiftUI, security audit, crypto review, testing, research, build doctor
Slash commands7/build, /test, /run, /plan-feature, /review, /security-audit, /clean-derived
Hooks7Session start, file protection, dangerous-command guard, no-auto-commit guard, SwiftLint/SwiftFormat enforcer, incremental build, session summary
Skills1ios-bootstrap — scaffolds a new feature module following the conventions
MCP connectors5 recommendedXcodeBuildMCP, Apple mcpbridge, sosumi (Apple docs), GitHub, filesystem
CLAUDE.md templates3Global (~/.claude/), project (./), local override (gitignored)
Settings templates3Same three scopes, with sensible permission allow/deny lists

Quick install (one command)

curl -fsSL https://raw.githubusercontent.com/ashokvadivelu/claude-code-ios-pro/main/install.sh | bash

The installer is interactive: it asks before overwriting anything, backs up existing files to ~/.claude/backup-<timestamp>/, and lets you skip parts you don't want.


Install as a Claude Code plugin (recommended for teams)

If your team shares a repo, the plugin install adds the agents/commands/hooks/skills without touching personal config:

# Inside any Claude Code session
/plugin marketplace add ashokvadivelu/claude-code-ios-pro
/plugin install ios-dev-pro@claude-code-ios-pro

To make installation automatic for every teammate, add this to your project's .claude/settings.json:

{
  "enabledPlugins": {
    "ios-dev-pro@claude-code-ios-pro": true
  },
  "extraKnownMarketplaces": {
    "claude-code-ios-pro": {
      "source": {
        "source": "github",
        "repo": "ashokvadivelu/claude-code-ios-pro"
      }
    }
  }
}

Install manually (full control)

If you'd rather pick-and-choose, every file lives at a known path:

# 1. Clone the repo
git clone https://github.com/ashokvadivelu/claude-code-ios-pro.git
cd claude-code-ios-pro

# 2. Copy global templates (your personal iOS-dev brain)
mkdir -p ~/.claude
cp templates/home/CLAUDE.md ~/.claude/CLAUDE.md
cp templates/home/settings.json ~/.claude/settings.json

# 3. Copy agents/commands/hooks into the user scope
cp -R plugin/agents ~/.claude/agents
cp -R plugin/commands ~/.claude/commands
cp -R plugin/hooks/scripts ~/.claude/hooks
chmod +x ~/.claude/hooks/*.sh

# 4. In your iOS project, copy the project templates
cd /path/to/your/ios/project
mkdir -p .claude
cp /path/to/claude-code-ios-pro/templates/project/CLAUDE.md ./CLAUDE.md
cp /path/to/claude-code-ios-pro/templates/project/settings.json .claude/settings.json
cp /path/to/claude-code-ios-pro/templates/project/.mcp.json ./.mcp.json

The subagent team

Each subagent runs in an isolated context window — you don't lose your main thread when they work.

NameModelTriggerRole
ios-architectOpusArchitecture / module / refactor questionsSystem design, layer boundaries, dependency direction
swift-reviewerSonnet"Review this code"Idioms, concurrency safety, force-unwraps, retain cycles
swiftui-specialistSonnetSwiftUI view, state, navigation workState management, view extraction, performance
ios-security-auditorOpusSecurity review, Keychain, biometrics, ATSOWASP MASVS-aligned audit
crypto-reviewerOpusAny cryptographic codeAlgorithm choice, key management, randomness
ios-test-engineerSonnetTest writing, coverage, mocksSwift Testing, snapshots, dependency injection for testability
ios-researcherSonnetApple API / WWDC / Swift Evolution questionsUp-to-date framework research with citations
build-doctorSonnetBuild failures, code signing, dependency hellDiagnose xcodebuild errors and fix them

Invoke explicitly with "Use the <agent-name> to …" or let Claude pick automatically based on your prompt.


Hooks: turn suggestions into enforced workflow

EventScriptWhat it enforces
SessionStartsession-start.shPrints project name, Swift version, branch, simulator state
PreToolUse (Edit/Write/MultiEdit)file-protection.shBlocks edits to .env*, *Secrets.*, GoogleService-Info.plist, entitlements, .git/, Podfile.lock, .swiftlint.yml, .swiftformat, and more
PreToolUse (Bash)dangerous-commands.shBlocks rm -rf /, git push --force, destructive resets
PreToolUse (Bash)no-auto-commit.shBlocks git commit, git push, git tag, git merge, git rebase, git cherry-pick, git revert — you review the diff and commit manually
PostToolUse (Swift files)swift-quality.shRuns SwiftFormat → SwiftLint; error-level violations block until fixed
PostToolUse (Swift files, opt-in)incremental-build.shTriggers background swift build for immediate error feedback (Swift packages only)
SessionEndsession-summary.shAppends summary to .claude/session.log

All hooks are shell scripts you can read, modify, or disable. None of them phone home.


MCP connectors (what to plug in)

See docs/CONNECTORS.md for full setup. The short list:

ConnectorWhyInstall command
XcodeBuildMCPBuilds, tests, simulators, screenshots — 59 tools, maintained by Sentryclaude mcp add --transport stdio XcodeBuildMCP -- npx -y xcodebuildmcp@latest
Apple mcpbridgeNative Xcode IDE access (Xcode 26.3+), SwiftUI preview renderingxcrun mcpbridge
sosumiSearches Apple developer documentation from inside the sessionclaude mcp add --transport stdio sosumi -- npx -y mcp-remote https://sosumi.ai/mcp
GitHub MCPPRs, issues, CI status, code review commentsVia Claude Code settings UI
Filesystem MCPScoped file access for files outside the projectVia Claude Code settings UI

CLAUDE.md scopes — what goes where

Claude Code merges three CLAUDE.md files in this order of precedence:

session flags  >  ./CLAUDE.md (project)  >  ~/.claude/CLAUDE.md (global)
ScopeFilePurposeExamples
Global~/.claude/CLAUDE.mdYour personal iOS-dev brain, every projectSwift 6 by default, MVVM defaults, SwiftLint enforced, no force-unwraps, no print() in committed code
Project./CLAUDE.mdProject-specific rules, shared via gitMin iOS target, module structure, naming conventions, project-specific frameworks
Local./CLAUDE.md.local or .claude/settings.local.jsonPersonal overrides for this project, gitignoredYour simulator preference, your branch naming, your sandbox tokens

All three templates are in templates/.


Recommended skill packs to layer on top

This repo intentionally doesn't bundle other people's skills — install them separately so you get updates:

# Inside Claude Code
/plugin marketplace add AvdLee/Swift-Concurrency-Agent-Skill
/plugin install swift-concurrency@swift-concurrency-agent-skill

/plugin marketplace add AvdLee/SwiftUI-Agent-Skill
/plugin install swiftui-expert@swiftui-expert-skill

/plugin marketplace add AvdLee/Swift-Testing-Agent-Skill
/plugin install swift-testing-expert@swift-testing-agent-skill

/plugin marketplace add AvdLee/Core-Data-Agent-Skill
/plugin install core-data-expert@core-data-agent-skill

/plugin marketplace add CharlesWiltgen/Axiom
/plugin install axiom@axiom

# For security-sensitive apps (wallets, fintech, healthcare)
/plugin marketplace add trailofbits/skills

See docs/SKILLS.md for the full curated list and why each is worth installing.


Documentation


Requirements

  • macOS 13+ (Ventura or later)
  • Xcode 16+ (Xcode 26.3+ unlocks the native Claude Agent integration)
  • Claude Code ≥ 2.0 — install from claude.com/install
  • Node.js 18+ — for XcodeBuildMCP and other npx-based connectors
  • SwiftLint and SwiftFormat (optional but recommended) — brew install swiftlint swiftformat

Philosophy

A few principles this repo follows so you know what you're getting:

  1. Generic by default, specific where it matters. The defaults work for any iOS app; opinionated where opinions reduce ambiguity (Swift 6 strict concurrency, SwiftUI-first, @Observable).
  2. Hooks enforce, agents advise. Linting and dangerous-command guards are non-negotiable; architecture suggestions are advisory.
  3. You commit, Claude doesn't. Claude is blocked from running git commit, git push, git tag, git merge, git rebase, git cherry-pick, or git revert. You review the diff and commit yourself.
  4. No "47 generic agents" bloat. Eight focused subagents, each with a distinct trigger. More crowds context and confuses the router.
  5. Security on by default. OWASP MASVS posture, Keychain over UserDefaults, blocked edits to secrets, entitlements, and even SwiftLint config — out of the box.
  6. Plays well with others. Doesn't bundle AvdLee/Axiom/Trail of Bits skills — points you at them so you get updates from the source.

Contributing

PRs welcome. The simplest contributions:

  • New subagent? Drop a .md in plugin/agents/ with frontmatter and a clear trigger description.
  • New hook? Shell script in plugin/hooks/scripts/, bind it in plugin/hooks/hooks.json.
  • New command? .md in plugin/commands/ with description and allowed-tools.

See docs/CUSTOMIZATION.md for the patterns.


License

MIT — see LICENSE. Use it, fork it, ship it.


Credits & inspiration

Standing on the shoulders of:

Ver o original no GitHub

Bom para

Relacionados