ghost-proc-guard
Blocks duplicate dev-server launches and cleans leftovers from a /procs pane.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add thieung/claude-mods
/plugin install ghost-proc-guard@thieung-mods
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add thieung/claude-mods
claude plugin install ghost-proc-guard@thieung-modsThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "ghost-proc-guard" (https://github.com/thieung/claude-mods). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add thieung/claude-mods and claude plugin install ghost-proc-guard@thieung-mods, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/thieung/claude-mods
cd claude-mods
claude --plugin-dir ./ghost-proc-guardClone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads Bash command text plus package.json, workspace and vite/astro/wrangler configs to infer ports.
Writes files
YesStores launched-server records in the plugin store so later sessions can list leftovers.
Runs commands
YesRuns lsof, ps and git worktree; sends TERM/KILL to an app tree only when you press Stop.
Network
NoneIntroduction
ghost-proc-guard is a Claude Code function-hooks mod that, before Bash starts dev servers such as npm run dev, Vite, Next or uvicorn, figures out ports and folders and refuses a launch when the port is taken or the same folder already has a server. It understands monorepos and git worktrees, tags allowed launches with a session marker, and offers a /procs pane to stop tracked process trees. No network. It runs lsof, ps and git worktree, and kill only when you press Stop. Author tested on macOS. Needs Claude Code 2.1.287+. Preview is illustrative.
Who it is for
- People who juggle worktrees and keep spawning duplicate Vite/Next servers
Requirements
- Claude Code ≥ 2.1.287
- Platforms · macOS
- Author tested on macOS; session ownership uses BSD ps -E.
- Only Bash launches from Claude are checked, not servers you start yourself.