christiandrapatz.de
Personal site, projects, contact and background on my development work.
Free · DE / EN · macOS 13+
xcodex
Your essential Xcode workflow. One command.
Clean, build, test, and control your Simulator — without looking up flags or switching tools.
6
Categories
30+
Actions
0
Dependencies
Why xcodex?
One command. Every workflow.
In everyday Apple development you constantly switch between Xcode, Terminal, and various CLI tools. xcodex puts everything in one place.
No flag lookup
Every common workflow is a menu entry. Arrow keys navigate, Enter executes.
No context switching
Build, Test, Clean, and Simulator control all run in the same terminal window. Stay in flow.
Zero setup
No external dependencies. Runs wherever Xcode is installed — one alias and you're done.
Features
Six categories. Every daily workflow.
Everything you reach for every day — directly accessible from a single, clean interface.
Clean & Cache
Remove build artefacts, clear DerivedData, Simulator caches, and module caches in a single step.
xcodebuild clean
Delete DerivedData
Delete Simulator Cache
Delete Xcode Caches
Dependencies
Resolve and inspect SPM, CocoaPods, and Carthage dependencies — without memorising the flags.
Show resolved dependencies
Resolve SPM
Resolve CocoaPods
Resolve Carthage
Build & Run
Compile and launch with preset optimisations — Quick Reset, Full Reset, or straight Build & Run.
Build
Build & Run
Quick Reset & Build
Full Reset & Build
Simulator
Launch, restart, reset, screenshot, and record your Simulator. Toggle Dark/Light Mode without leaving the terminal.
Launch app
Restart Simulator
Screenshot → Desktop
Dark / Light Mode
Test
Run unit tests, UI tests, or all tests at once — with build speed optimisations applied automatically.
Run unit tests
Run UI tests
Run all tests
Xcode
Open or close your Xcode project directly from the menu. No Finder detour.
Open project in Xcode
Close Xcode
Interface
Split-pane. Keyboard-driven.
Categories on the left, actions on the right. Navigate with arrow keys, execute with Enter. Your settings are saved automatically between sessions.
↑↓
Navigate within the active pane
←→
Switch between category and action pane
↵
Execute the selected command
Settings are saved in ~/.xcode_toolbox_prefs.json
Installation
Up and running in seconds.
1
Clone the repository
git clone https://github.com/drapatzc/xcodex.git ~/GIT-Home/xcodex
2
Set execution permissions
chmod +x ~/GIT-Home/xcodex/xcodex
3
Set up a shell alias
zsh (default on modern Macs)
echo 'alias xcodex="$HOME/GIT-Home/xcodex/xcodex"' >> ~/.zshrc && source ~/.zshrc
bash
echo 'alias xcodex="$HOME/GIT-Home/xcodex/xcodex"' >> ~/.bash_profile && source ~/.bash_profile
4
Run inside your Xcode project
cd MyXcodeProject
xcodex
xcodex detects .xcworkspace and .xcodeproj files automatically.
Updating
cd ~/GIT-Home/xcodex && git pull
Controls
Every shortcut at a glance.
| Key | Action |
|---|---|
| ↑↓ | Move up / down in active column |
| ←→ | Switch column (category ↔ action) |
| ↵ Enter | Execute selected command |
| Q | Quit the app |
| S | Select scheme |
| D | Select device / simulator |
| K | Configuration (Debug / Release) |
| B | Set bundle ID |
| L | Switch language (DE / EN) |
| A | Select working directory |
Requirements
macOS 13+
Tested from macOS Ventura onwards
Xcode
Including Command Line Tools
Swift 5.9+
Included with Xcode
Christian Drapatz
I build software for the Apple ecosystem — native iOS and macOS apps, developer tools, and games. My focus is on products that are technically clean, practical in everyday use and able to stand on their own.
betterlocale.com
AI-powered macOS tools for iOS and macOS developers — designed to plug into the daily workflow.
atomiumgames.com
Independent iOS games — built inside the Apple ecosystem, developed and published in-house.
onetwoapps.de
Practical apps for iOS and macOS — clear concepts, standalone products.
Licence
Free for everyone. Transparent by design.
No subscriptions, no feature gates, no hidden conditions.
Free & flexible to use
xcodex is free to use in private projects as well as professional and commercial environments. No registration, no license key, no telemetry.
- Private use
- Commercial use
- Team-wide rollout
- Unlimited installations
What is not allowed
The software is provided as a compiled binary. All rights remain with the author.
- Sell or resell the software
- Redistribute as a standalone product
- Include in paid products without permission
- Reverse engineer or extract source code
Disclaimer
This software is provided "as is", without warranty of any kind. Use is at your own risk. The author is not liable for any damages arising from the use of this software.
Copyright
© 2026 Christian Drapatz · All rights reserved
Support
Enjoying xcodex?
If this tool saves you time in your daily development work and you would like to support its ongoing maintenance, a small PayPal donation is warmly welcomed. Every contribution helps keep the project alive.
PayPal recipient
c.drapatz@gmx.de
Donations are voluntary and do not change the licence, the feature scope or any warranty. They simply allow me to keep investing time into the project.