{
  "markdown": "# TidyPorts integrations\n\nLet your coding agent see and control the local dev servers it starts.\n\nIf you run Claude Code, Cursor or Codex across several git worktrees, each one starts dev\nservers you never typed a command for. Ports collide, and an agent that hits `EADDRINUSE`\noften can't tell a port conflict from a bug — so it \"fixes\" working code instead.\n\nThese integrations give the agent a way to look, rather than guess.\n\n| | |\n|---|---|\n| [`mcp/`](mcp/) | An [MCP](https://modelcontextprotocol.io) server — typed tools for any MCP client (Claude Code, Cursor, Claude Desktop, Windsurf, Zed). |\n| [`skills/`](skills/) | A Claude Code skill, if you'd rather it shelled out to the CLI directly. |\n| [`guard/`](guard/) | Wrap your dev command so `EADDRINUSE` names what is holding the port, instead of only saying that something is. |\n| [`raycast/`](raycast/) | A Raycast extension for the same list, without leaving the launcher. |\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_servers` | Listening dev servers: port, process, branch, owner, idle. Read-only. |\n| `kill_port` | Stop the server on a given port. |\n| `alloc_port` | A stable, collision-free port for this worktree — the fix for parallel agents fighting over `:3000`. |\n| `free_port` | A port nothing is listening on right now, to bind immediately. |\n\n## Install\n\nThe skill, for any agent (Claude Code, Cursor, Copilot, Gemini…):\n\n```sh\nnpx skills add dan-fetch-studio/tidyports-integrations\n```\n\nThe MCP server:\n\n```sh\nnpm install -g @tidyports/mcp\n```\n\nThen register it with your client, pointing at the installed `tidyports-mcp` binary. For\nClaude Code:\n\n```sh\nclaude mcp add tidyports -- tidyports-mcp\n```\n\n### It needs the TidyPorts app\n\nThese are a thin layer over the `tidy-ports` CLI, which ships inside\n[TidyPorts](https://tidyports.app) — a free macOS menu-bar app that shows every dev server\nrunning on your Mac and which agent started it.\n\n```sh\nbrew install --cask dan-fetch-studio/tap/tidyports\n```\n\nOr download it from [tidyports.app/download](https://tidyports.app/download). macOS 15+.\n\n## Licence\n\nThe integrations here are MIT (see [LICENSE](LICENSE)). The TidyPorts app itself is\nsource-available under its own licence.\n",
  "bytes": 2215,
  "sha": "aa5c8d42bf4527fd16260f5caba7fa21a96097d027345e4f353b82b41ef7e3da",
  "repo_slug": "dan-fetch-studio/tidyports-integrations",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dan_fetch_studio_tidyports_9cb3d6fa/readme"
}