For iOS and macOS developers
Xcode Developer Toolbox brings build, test, simulator control, code quality, Git analysis, distribution and security into a single keyboard-driven menu — pure Swift, zero external dependencies.
The problem
Clearing DerivedData. Restarting simulators. Running tests on three OS versions. Hunting force-unwraps. git blame. Shipping an IPA. Every tool has its own flags, its own syntax, its own gotchas. Context switching costs time — every day, every hour.
xcodebuild, simctl, agvtool, otool, codesign, git, swiftlint — each tool, a world of its own.
The build is green locally and red remotely. Feedback arrives too late.
Clean, reset, build, test, coverage, report. Same steps. Every time. By hand.
The answer
Xcode Developer Toolbox is a pure Swift CLI that turns 100+ common developer tasks into a keyboard-driven terminal menu. No clicks. No flag lookups. No context switching.
Build, launch and test — on real devices or in parallel across multiple simulator runtimes. Live output, SIGINT-safe, always one keystroke away.
59 code-quality checks, 38 project analyses, a quality score and exportable reports — all without an external CI pipeline.
Read-only Git queries, IPA export, notarisation, secret scanning and signing — in one menu, without guessing flags.
Features
24 topic areas, 215+ individual actions. Here are the highlights.
DerivedData, module cache, simulator data and SPM cache — targeted or full. Nothing accidental.
Swift Package Manager, CocoaPods and Carthage — status, updates and cache reset from a single menu.
One keystroke builds and launches your app on iOS 16, 17 and 18 at the same time. Live output in one place.
Tests across multiple simulator runtimes, code coverage and exportable reports in JUnit and Markdown.
Dark/Light mode, location, language, push notifications, clipboard, SQLite, permissions, keychain — all controllable.
Capture from the running simulator straight to your desktop — no Xcode detour.
Recurring local builds with clean, cache reset and tests — configurable from 2 minutes to 24 hours.
SwiftLint, SwiftFormat, Periphery and 59 custom pattern checks: force-unwraps, retain cycles, magic numbers, TODO/FIXME.
Quality score, risk ranking, documentation coverage, SwiftUI-vs-UIKit ratio — exportable as Markdown.
23+ read-only queries: history, blame, author stats, branch comparison, pickaxe search, CSV export.
Secret scanning, ATS check, Privacy Manifest, entitlements, code-signing status and notarisation.
Archive, IPA export, TestFlight, App Store, notarisation and release checklist — step by step.
Spotlight · Auto-build
The auto-build scheduler builds your project on a cadence you choose — including clean, DerivedData reset, build and tests. Errors surface earlier, before they reach your real CI. Every cycle lands in a log file. Runs quietly in the background while you keep working.
[11:30:02] Cycle 47 started
[11:30:02] ├ Clean DerivedData ✓
[11:30:04] ├ Reset module cache ✓
[11:30:05] ├ Build Debug ✓ 28.4s
[11:30:33] ├ Run Unit Tests ✓ 142/142
[11:31:12] └ Write report ✓
[11:31:12] ✓ Cycle 47 · 70.2s · pass
[11:40:02] Cycle 48 started
[11:40:27] ├ Build Debug ✗
[11:40:27] LoginView.swift:42 · force unwrap
[11:40:27] ✗ Cycle 48 · 25.1s · fail
Spotlight · Multi-simulator
Build and test on iOS 16, 17 and 18 simultaneously — controlled from a single menu, with synchronised live output. Perfect for catching cross-version regressions before the pull request goes out.
Spotlight · Code quality
From force-unwraps and retain cycles to hardcoded credentials and missing Swift Concurrency conformance — no external CI pipeline required, everything on demand.
Quality · Security · Control
All analysis and Git functions are strictly read-only. No automatic code changes, no accidental reset.
No cloud, no telemetry. Everything runs on your machine. No external Swift dependencies — only Foundation and the Xcode Command Line Tools.
Any running operation can be cleanly aborted with CtrlC — no crash, no hanging terminal.
Scheme, device, configuration, language and menu mode live in ~/.xcode_toolbox_prefs.json and are ready on next launch.
Global shortcuts for scheme, device, configuration, bundle ID, language, mode and help — reachable from every menu.
Fully localised — German, English, French, Spanish, Portuguese, Chinese (Simplified & Traditional), Japanese, Korean, Arabic and more.
Facts & figures
Who it's for
Everything in one place. No tool switching, no scattered scripts, no flag lookups from memory.
Unified toolchain, shareable configurations (default · developer · senior) — every team member on the same setup.
Local pre-flight check before pushing. The same clean-build-test cycle, without the wait.
17 languages, switchable at runtime. Every team member works in their own language.
Installation
macOS 13+, Xcode with Command Line Tools. No other requirements.
Download the toolbox into a directory of your choice.
git clone https://github.com/drapatzc/toolbox.git ~/GIT-Home/toolboxA one-time chmod and the binary is ready to run.
chmod +x ~/GIT-Home/toolbox/toolboxSo you can launch the toolbox with toolbox from anywhere.
echo 'alias toolbox="$HOME/GIT-Home/toolbox/toolbox"' >> ~/.zshrc
source ~/.zshrcThe toolbox detects .xcworkspace and .xcodeproj automatically.
cd MyXcodeProject
toolboxA few menu items use third-party tools. Without them, everything else still works.
brew install swiftlint
brew install swiftformat
brew install peripheryLicense
No subscriptions, no feature gates, no hidden conditions.
The Xcode Developer Toolbox is free to use — in private projects as well as in professional and commercial environments. No registration, no license key, no telemetry, no artificial limits.
The software is provided “as is”. No guarantee is made for functionality, stability or fitness for a particular purpose. Use at your own responsibility — review what runs on your machine before integrating it into critical workflows.
Because the source is available, you can inspect, audit and adapt every step yourself.
Support the developer
If the Xcode Developer Toolbox is useful to you in your daily work and you would like to support its ongoing development, a small PayPal donation is warmly welcomed. Every contribution helps keep the project maintained and evolving.
Support via PayPalc.drapatz@gmx.deDonations are voluntary and do not change the license, the feature scope or any warranty. They simply allow me to keep investing time into the project.