All shelves / Mods / Workflow
portpilot
By m4cd4r4
portpilot is a Claude Code workflow mod by m4cd4r4.
For PortPilot, a Windows and Linux app that runs your dev servers, draws their state and a crash band, and turns away a second start of a running server.
DrawsHolds a command
Install
The marketplace name is portpilot.
/plugin marketplace add m4cd4r4/PortPilot /plugin install portpilot@portpilot
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 4.0.4
- License
- MIT
- Repo stars
- 16
- Last change
- 2026-10-18
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
- Runs a command when you press
- Calls another program on this machine
Needs the PortPilot app on Windows 10 or 11 or Linux. The plugin bundles PortPilot's MCP server, so there is no separate npm install. A clean start goes through PortPilot, and a command the guard cannot read is let through. The status line leads with the worst state and marks the apps Claude started. When an app Claude started crashes, the band offers Fix it, Restart, Logs, and Dismiss. Fix it sends Claude the crash and the last stderr lines, and Restart starts the app again through PortPilot. Claude can list, start, stop, and scan the servers, kill a port, and start the browser profile you described for a site. At the start of a conversation a short list of your browser profiles is added, at most 25 profiles and 2 KB, and nothing when you have none. The author says PortPilot has no account, no telemetry, and no cloud.
The install name is portpilot. PortPilot is a local dev-server manager: a desktop app, a web portal, a VS Code sidebar, and this plugin. The crash band is why this page files it under workflow. peek-vedantandhale opens a pane of background shells and subagents, with elapsed time and their last output lines. This one draws the dev servers PortPilot runs and their crashes, and points a second start at the server already running. The list of browser profiles is added to what the model reads.
Demo

What it hooks into
session.startWhen a session startsprompt.contextA Claude Code eventtool.callAround a tool call, where it can hold oneBashui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's source, 7 files. They load when you open them.
Facts
- Author
- m4cd4r4
- Category
- Workflow
- Marketplace
- portpilot
- Folder
- plugin
- Version
- 4.0.4
- License
- MIT
- Repo stars
- 16
- Last change
- 2026-10-18
- Language
- JavaScript
- Files
- 35