spawnsweep
macOS menu bar cleaner for AI coding agents (Claude Code, Codex, Cursor). Finds leftover dev servers, busy ports, simulators, Docker stacks and git worktrees, and cleans them up with a preview first. Native SwiftUI, open source, everything stays on your Mac.
Install / Use
claude mcp add samirmaikap -- npx -y github:samirmaikap/spawnsweepIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OperationsSupported Platforms
Our assessment of spawnsweep
spawnsweep scores 83/100 on our quality scale, 593rd of 753 Operations skills we index.
Its MCP Server is 18 KB long, well organised into 22 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so spawnsweep is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
spawnsweep compared with similar skills
All 4 of these similar skills score higher than spawnsweep; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| spawnsweep (this skill)by samirmaikap | 83 | 3 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.7k | 10d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install spawnsweep?
- Run
claude mcp add samirmaikap -- npx -y github:samirmaikap/spawnsweep. The install tabs above show the steps for each supported agent. - Which AI agents does spawnsweep work with?
- It is written for Claude Code, Claude Desktop, Cursor and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is spawnsweep safe to use?
- It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is spawnsweep still maintained?
- The repository was last updated today, so spawnsweep is actively maintained.
Skill content
View source on GitHubClean up after AI coding agents on macOS
Error: Port 3000 is already in use, again.- Yesterday's
next dev,viteandvitest --watch, still running from sessions you closed hours ago. - An iPhone simulator holding 1.6 GB of memory since lunch.
- A hundred git worktrees, each with its own
node_modules.
SpawnSweep is a free, open-source Mac app that cleans up after AI coding agents. It groups detected resources by agent session when it can identify their owner. Review what to stop or remove from Claude Code, the Claude desktop app, Codex, Cursor, Gemini CLI and Aider sessions.
Native SwiftUI for macOS 14 or later on Apple silicon. The core app is free and open source under the MIT license. SpawnSweep Pro is a one-time $9 purchase for up to 3 Macs. Cleanup scans run locally.
Install
- Download SpawnSweep.zip from the project’s GitHub release.
- Extract the ZIP and move SpawnSweep.app to Applications.
- Open the app. The download includes Pro features that you can unlock with a key. The free features are available immediately.
If you prefer Terminal, review the installer source first. The script downloads the latest release, replaces an existing copy in Applications or ~/Applications, and launches the app.
curl -fsSL https://raw.githubusercontent.com/samirmaikap/spawnsweep/main/scripts/install.sh | bash
If macOS says "SpawnSweep" Not Opened
The current release uses ad hoc signing. macOS can block its first launch. After verifying that your download came from the project’s GitHub release, open System Settings → Privacy & Security and use Open Anyway for SpawnSweep. See release verification for the ZIP digest and signing checks. You can also build the free edition from source.
Highlights
<p align="center"> <img src="docs/images/this-mac.jpg" width="49%" alt="SpawnSweep This Mac page: disk space, memory, junk files and large files on macOS"> <img src="docs/images/autopilot.jpg" width="49%" alt="SpawnSweep Autopilot: dry-run cleanup rules for idle simulators, finished agent sessions, end of day, battery saver and quiet git worktrees"> </p>- Detected agent sessions and resources. Review dev servers, watchers, headless browsers and tunnels associated with Claude Code, the Claude app, Codex, Cursor, Gemini CLI and Aider.
- A ports board. See detected developer listeners with project, branch, uptime and session context where available. Review the process before freeing a port.
- Git worktrees under control. Size and status per repo. Slim the rebuildable folders, push and remove, or recycle merged ones, with eligible ignored files such as
.envsaved for restoration during the retention window. - Simulators and Docker. Booted simulators and emulators, unused simulator devices, and Docker stacks, each stopped as one unit.
- Know when something starts. A notification when an agent session starts, a simulator boots or a worktree appears, each with its own switch.
- Inside Claude. A 🌔 with the count of what's running in Claude's footer opens a pane beside your chat. More below.
- Autopilot. Rules that start as dry runs: simulator bedtime, finished-session leftovers, end of day, battery saver, low disk, merged worktrees.
- Review and recovery. Manual previews, guarded process stops and an activity log with recovery actions where available. Cleanup safeguards.
The menu bar shows what's running right now, memory used, disk free, and one button to put leftovers away.
Mac cleanup guides
Start with the AI coding agent cleanup checklist for parallel projects, or follow a guide for Claude Code, Codex, or Cursor.
- Find and free a localhost port or fix port 3000 already in use.
- Stop orphaned dev processes or stop a leftover Docker Compose stack.
- Reclaim developer disk space, review old Git worktrees, or clean up unused Xcode simulators.
- Compare scope with CleanMyMac.
SpawnSweep is also listed on OpenMacApps and AlternativeTo.
Inside Claude
A plugin for Claude Code and the Claude desktop app puts what SpawnSweep sees in a pane next to your chat: each agent session with its dev servers, ports and Docker stacks, loose simulators, and your git worktrees. A moon with the count of what's running (🌔 4) sits in the footer; click it, or type /spawnsweep, to open the pane. It refreshes every 30 seconds and needs SpawnSweep in Applications.
The easiest way to add it: open SpawnSweep and click Add to Claude on the Sessions page, or turn on Connections › Claude Code pane. Or, at the prompt of a Claude Code terminal session:
/plugin install spawnsweep --marketplace samirmaikap/spawnsweep
In the desktop app, click + next to the prompt box, then Plugins, Add marketplace with samirmaikap/spawnsweep, then Add plugin. The plugin's source and details are in claude-plugin/.
SpawnSweep also gives agents an MCP server they can ask "is a dev server already running for this repo?" before starting another one, and a Claude Code SessionEnd hook that puts away what a session started when it ends. Both are a click away in Connections.
How it compares
| | By hand in Terminal | General Mac cleaners | SpawnSweep |
|---|---|---|---|
| Leftover dev servers, watchers, headless browsers | Find each one with ps or lsof, then kill it | Not their focus | Grouped by the agent session that started them, stopped gently after a preview |
| Busy ports | lsof -i :3000, one port at a time | Not their focus | Detected developer listeners with project, branch and session where available |
| Which agent started what | Inspect ancestry and working directories | Varies by tool | Associates known agent processes and resources when a link is available |
| Git worktrees | git worktree list and remove; ignored files like .env go with it | Not their focus | Size and status per repo; slim or recycle, and restore later |
| Simulators and Xcode build data | xcrun simctl, delete DerivedData folders | Some clear DerivedData | Lists sizes and reviews unused simulators and orphaned DerivedData. Pro adds broader cache cleanup. |
| App caches, logs, large files | du and manual deletion | Their core feature | With Pro |
| Cleans up on its own | Your own scripts | Scheduled scans | Autopilot rules that start as dry runs; acting on their own with Pro |
SpawnSweep Pro
Everything above is free unless it says Pro. Pro adds the parts that clean your whole Mac and work on their own:
- Junk cleaner: app caches, logs, npm/Yarn/Gradle/Homebrew caches, Xcode leftovers and old installers. Open apps and IDE local history are left alone.
- Large & old files: big files you haven't opened in months, each with the reason, sent to the Trash so nothing is lost.
- Autopilot that acts: rules that ask first with a notification, or act on their own and log a way back.
- Rules that run themselves: clean up at the end of the day, battery saver when unplugged, room to breathe when the disk runs low.
The official download scans for free, so you can see what Pro would clean before you decide. Pro is a one-time $9 purchase through Dodo Payments; the key arrives by email and you paste it into Settings › SpawnSweep Pro in the official download. Source builds don't include Pro, so a key does nothing there. A key works on up to 3 Macs and keeps working offline for weeks between checks.
<p align="center"> <a href="https://checkout.dodopayments.com/buy/pdt_0Nqn3fOmfcDQwcQysr6t5?quantity=1"><img alt="Get SpawnSweep Pro, $9 once" src="https://img.shields.io/badge/Get%20SpawnSweep%20Pro-%249%20once-0E9F5B?style=for-the-badge"></a> </p> <p align="center"> <img src="docs/images/pro.jpg" width="70%" alt="SpawnSweep Pro: junk cleaner and large & old files finder for Mac"> </p>Safety
SpawnSweep deletes as little as possible and asks first.
- Manual cleanups start with a preview. Session sweeps skip active and pinned sessions.
- The process scan is scoped to your macOS user. Stops recheck the process start time before each signal, send TERM first, and use KILL for survivors.
- Slim removes only folders git ignores by their own name (
node_modules,.next,dist, …), never a folder that holds tracked files, and never in a worktree something is running in. - Recycle saves eligible ignored files under the backup limit (
.env, keys, local databases) beforegit worktree remove(never--force). Branches stay in Git. Backups are capped at 500 MB. Restore can recreate the checkout and saved files during the retention period. - Junk (Pro) only touches folders apps and tools can rebuild, re-checks each item right before removing it, refuses anything that resol
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
