ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add m4cd4r4/PortPilot
/plugin install portpilot@portpilot
Open the repo

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

A rendered sample of the status line: 1 crashed, 7 up, 550-au marked with a diamond, port 3000 examworthy-web, port 3002 examworthy-web marked with a diamond, and +5.
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • prompt.contextA Claude Code event
  • tool.callAround a tool call, where it can hold oneBash
  • ui.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
Repo
m4cd4r4/PortPilot
Folder
plugin
Version
4.0.4
License
MIT
Repo stars
16
Last change
2026-10-18
Language
JavaScript
Files
35

Other mods in Workflow

enilUnayungOpens a LINE chat pane from enil, a terminal LINE client, to read and answer chats. A message you send goes to LINE through your enil daemon.followupdedeneQueues a prompt while Claude works, draws the queue above the prompt, and sends each one as your message once the turn and its background agents finish.swarmOneWave-AIDraws a live pane of your subagents: who spawned whom, how they overlap, and the messages between them.dispatch-boardHangghostDraws a board of the mission files you write, showing which session is done, running, or waiting on you.handoff-runnerHangghostLets a background session hand you a finished worktree branch, and fast-forwards it when you press the pane's run button.qa-guideaieo-productWhen Claude asks a question, opens a pane that explains why, what each option does, and which option it would pick.workflow-watchalonbaronFollows the session's newest Workflow run and draws each stage live in a pane, a band above the prompt, and the status line.aicqashfulcraDraws AICQ, Fulcra's agent-to-agent work: your agents, friends' agents, and the collaborations under way, and answers new messages in the mode you set.gh-accountVedantAndhaleRuns each git or gh step as the logged-in GitHub account that owns that repository or is in its organization, and counts them on the status line.lightningLightning-AIDraws a live progress bar above the prompt for each Lightning AI job, with skills for that cloud platform's GPU studios, batch jobs, and deployments.ccfnaniilujaKeeps planning in plan mode, checks work against the project spec, runs slices in parallel, and can draw the task, the board, and the waves.roadraven-hudShuffzordDraws a live pane of RoadRaven, a local desktop plan tree, with agents on each node, UAT you pass or fail, and a backlog you can start.
All 396 in Workflow