REVIEWED & READY TO INSTALL
simslim
mobai-app/simslim
CLI and macOS app that turns off around 180 background services an iOS Simulator does not need (Siri, Spotlight, iCloud, widgets…), cutting each simulator’s memory roughly 4x (4.0 GB to 0.9 GB) so one Mac can run many more simulators for development, testing, and CI.
STEP BY STEP
How to install simslim
The step-by-step guide is right on this page, written for people who have never installed anything from GitHub.
Updated 9/30/2026SIGNUP BONUS
Sign up and get 5 xu to try the AI tools
Every new GitHot account gets 5 xu — enough to run the AI Repo Explainer, MCP Config Generator or Repo Health Check. Free, just an email or Google.
- GitHub stars
- 4,334
- Language
- Go
- Added
- 9/24/2026
How to install simslim, step by step
Work from top to bottom. Each grey box is one command: copy the whole line, paste it into the terminal window and press Enter.
Never used a terminal? Read this first (1 minute)
A terminal is a window where you type commands for your computer. You do not need to understand them, just copy and paste them exactly.
- Windows: press the Windows key, type "PowerShell", then press Enter.
- macOS: press Command + Space, type "Terminal", then press Enter.
- Linux: press Ctrl + Alt + T.
- Copy a command from the guide, right-click inside the window you just opened to paste it (macOS: Command + V), then press Enter.
- Wait for the command to finish (the cursor blinks again on a new line) before running the next one.
Lines starting with # are notes; you do not need to copy them. If red error text appears, check the common errors section at the end of the guide.
1. What is simslim?
simslim is a small tool for the Mac that makes iOS simulators (the "pretend iPhones" bundled with Xcode that developers use to test apps) use far less memory. A freshly started simulator runs around 180 background services such as Siri, Spotlight indexing, photo analysis and iCloud sync. When the simulator is only there to test an app, most of that is dead weight. simslim switches it off.
In the project's own measurement on a 16 GB M1 Pro MacBook, one simulator went from 258 processes to 70 and from 4.0 GB of memory to 0.9 GB. That means the same Mac can keep many more simulators open at once.
To be direct: this is a tool for iOS developers and testers. It does not speed up a real iPhone, it does not clean your Mac, and it does not run on Windows. It is free and open source (MIT licence).
A good fit if:
- You build iOS apps and your Mac struggles with several simulators open.
- You run automated tests in parallel, or have several AI agents each driving its own simulator.
- You want to reclaim disk space taken by simulators.
Not a good fit if:
- You do not use Xcode and the iOS Simulator.
- You are on Windows or Linux.
- The app you test leans heavily on Siri, iCloud or system search: you can still use simslim, but you will have to keep those service groups switched on.
2. What you need
- A Mac. simslim is macOS only.
- Xcode with at least one iOS Simulator runtime. Xcode is Apple's free developer toolkit; simslim controls simulators through it. Get it from https://developer.apple.com/xcode/ or the Mac App Store.
- Homebrew: a command-line installer for macOS software, used by the easiest install route. Official site: https://brew.sh
- Go (only for the second install route, or to build the graphical app yourself): the programming language simslim is written in. Download it from https://go.dev/dl/
- No account, no API key, no cost.
The simulator's iOS version matters:
| Simulator iOS version | What simslim can do |
|---|---|
| iOS 18.5 and newer | Switch services off and keep the slim state across every reboot. |
| iOS 17.x and 18.3 | Slim the current session only, using --no-reboot. A reboot undoes it, so you run the command again. |
3. Step-by-step installation
Step 1: Check Xcode and your simulators
xcrun simctl list devices
You should see a list of simulators (iPhone, iPad), each followed by a long identifier. If you get an error, open Xcode once so it can install its missing components, and download an iOS Simulator runtime from Xcode's settings.
Step 2: Install simslim with Homebrew (recommended)
brew install mobai-app/tap/simslim
Homebrew downloads and installs it within moments. It worked if the command ends without a red error line.
Step 3: Check it
simslim list
You should see your simulators together with each one's slim status. Add --booted to show only the ones that are running.
Alternative: install with Go
If you already have Go and do not use Homebrew:
go install github.com/mobai-app/simslim/cmd/simslim@latest
Optional: the graphical macOS app
The project includes a SwiftUI app that bundles the command-line tool and adds live memory columns, per-service switches, and disk analysis and cleanup. At the time of writing the documentation only describes building it from source (Go and Xcode required). After downloading the repo's source code, run this inside that folder:
make app
open build/SimSlim.app
4. First use
Step 1: Find the simulator's identifier
simslim list
Every simulator has an identifier called a UDID (a long string of letters and digits). Copy the one for the simulator you want to slim. In the commands below, replace <udid> with it.
Step 2 (recommended): Clone the simulator as a backup
The project recommends cloning before changing services or cleaning disk data, so you have a copy to fall back on:
simslim clone <udid> "iPhone backup"
Step 3: Measure memory before slimming
Start the simulator and measure it:
simslim boot <udid>
simslim measure <udid>
Note the memory figure so you can compare later.
Step 4: Slim it
simslim on <udid>
simslim writes the "disabled" settings into that simulator and reboots it. From now on the simulator always starts slim.
For a simulator on iOS 17.x or 18.3, use this instead:
simslim on <udid> --no-reboot
Step 5: Measure again
simslim measure <udid>
It worked if the memory figure is clearly lower than in Step 3. Open your app in the simulator and test as usual.
Keep the features you need
See what simslim turns off:
simslim profiles
Keep a whole group, for example search:
simslim on <udid> --except search
Keep one specific service, for example push notifications:
simslim on <udid> --keep com.apple.apsd
The groups are: widgets, siri, search, icloud, store, pim, web, family, health, photos, apps, messaging, connectivity, telemetry, other.
Reclaim disk space (optional)
Preview what can be cleaned. This command only reads and deletes nothing:
simslim disk-plan <udid>
Clean for real:
simslim disk-clean --categories caches,logs,temporary --confirm <udid>
Note: Disk cleanup is permanent.
disk-cleanshuts that simulator down and refuses to run without--confirm.
5. Common errors and fixes
| Symptom | Cause | Fix |
|---|---|---|
simslim on refuses to run and mentions --no-reboot | The simulator runs an iOS older than 18.5, which cannot keep the settings across a reboot. | Run simslim on <udid> --no-reboot, and repeat it after every boot. |
context deadline exceeded | A slow machine (typically a shared CI runner) went past the default 10-minute limit. | Add --boot-timeout 15m or set SIMSLIM_BOOT_TIMEOUT=15m. If individual operations time out, add --spawn-timeout 5m. |
| Spotlight or in-Settings search returns nothing | The search group is off. | Run again with --except search. |
| Push notifications, StoreKit testing or universal links stop working | Push needs apsd, StoreKit needs storekitd (store group), universal links need swcd (web group). | Keep them with --except store,web or --keep com.apple.apsd. Verify with simslim doctor <udid> --requires push,storekit,universal-links. |
| The Contacts, Photos or Calendar pickers misbehave | Their service groups are off. | Keep pim or photos with --except. |
| The simulator is heavy again | You erased it, deleted and recreated it, or moved to a new iOS runtime. All of these return it to stock. | Run simslim on <udid> again; it applies only what is missing. |
simslim: command not found | The install did not finish, or you installed with Go and Go's program folder is not on your PATH. | Repeat the brew install command from Step 2. |
xcrun: error on any command | Xcode is not installed or has no iOS Simulator runtime. | Install Xcode, open it once and download a simulator runtime. |
6. Uninstalling and updating
Update:
brew upgrade simslim
The latest release at the time of writing is v0.11.0, published on 24 September 2026.
Remove completely: first put each simulator back to stock, then remove the tool.
simslim off <udid>
brew uninstall simslim
simslim off clears the disabled-service settings and reboots the simulator in its original state. If you uninstall simslim without doing this, the simulator stays slim until you erase it.
7. Frequently asked questions
Does simslim cost anything? No. It is open-source software under the MIT licence.
Does it change anything on my Mac? No. simslim only writes settings into the service database of the simulator you point it at. Your Mac, your other simulators and real iPhones are left alone.
Can I undo it?
Yes. simslim off <udid> returns the simulator to stock. The disk-clean cleanup, however, cannot be undone.
Which features do I lose inside the simulator?
That depends on the groups you turn off. The usual ones are Spotlight search, push notifications, StoreKit, universal links, and the Contacts, Photos and Calendar pickers. Every one of them can be kept with --except or --keep.
What about the simulators Xcode creates for parallel testing?
Those clones are created stock each time. The project offers simslim watch, which slims each simulator the moment it boots; see https://github.com/mobai-app/simslim
Written by GitHot and checked against the project's official documentation. If a step is wrong or unclear, message GitHot through the channels at the bottom of the page.
SEE WHY IT'S HOT
Watch the original review
Go back to the video that brought you here.
Don't miss the next repo
Every new repo gets a video review, with its install guide right here.