SkillAgentSearch skills...

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/spawnsweep

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Category

Operations

Supported Platforms

Claude Code
Claude Desktop
Cursor
OpenAI Codex

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
spawnsweep (this skill)by samirmaikap833todayMCP Server
Agent-Reachby Panniantong100112.7k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0k1d agoCLAUDE.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.
<p align="center"> <img src="docs/images/icon.png" width="120" alt="SpawnSweep icon"> </p> <h1 align="center">SpawnSweep</h1> <p align="center"> <strong>The macOS menu bar cleaner for AI coding agents.</strong><br> Reclaim disk space and recover system resources after Claude Code, OpenAI Codex or Cursor. Review dev servers, ports, Git worktrees, simulators and Docker stacks before cleanup. </p> <p align="center"> <a href="https://github.com/samirmaikap/spawnsweep/releases/latest/download/SpawnSweep.zip"><img alt="Download for macOS" src="https://img.shields.io/badge/Download-for%20macOS-0E9F5B?style=for-the-badge&logo=apple&logoColor=white"></a> &nbsp; <a href="https://samirmaikap.dev/spawnsweep/"><img alt="Website" src="https://img.shields.io/badge/Website-samirmaikap.dev%2Fspawnsweep-263A30?style=for-the-badge"></a> </p> <p align="center"> <a href="https://github.com/samirmaikap/spawnsweep/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/samirmaikap/spawnsweep?label=release&color=0E9F5B"></a> <img alt="macOS 14 or later on Apple silicon" src="https://img.shields.io/badge/macOS-14%2B%20on%20Apple%20silicon-263A30"> <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/github/license/samirmaikap/spawnsweep?color=263A30"></a> <img alt="Native SwiftUI" src="https://img.shields.io/badge/native-SwiftUI-263A30"> <a href="https://github.com/samirmaikap/spawnsweep/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/samirmaikap/spawnsweep?style=social"></a> </p> <p align="center"> <img src="docs/images/launch.gif" width="100%" alt="SpawnSweep demo: AI coding agents leave dev servers, ports, simulators and build data running on a Mac; SpawnSweep groups them by session and cleans them up"> </p> <p align="center"> <a href="#install">Install</a> · <a href="#highlights">Highlights</a> · <a href="#inside-claude">Inside Claude</a> · <a href="#spawnsweep-pro">Pro</a> · <a href="#mac-cleanup-guides">Cleanup guides</a> · <a href="#safety">Safety</a> · <a href="#faq">FAQ</a> </p>

Clean up after AI coding agents on macOS

  • Error: Port 3000 is already in use, again.
  • Yesterday's next dev, vite and vitest --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

  1. Download SpawnSweep.zip from the project’s GitHub release.
  2. Extract the ZIP and move SpawnSweep.app to Applications.
  3. 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 .env saved 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.

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) before git 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

View on GitHub
GitHub Stars3
CategoryOperations
Updated15h ago
Forks0

Languages

Swift

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low
spawnsweep — MCP Server: Install & Safety Check | SkillAgent