portr
Expose local http, tcp or websocket connections to the public internet
Portr-cli is an agent skill that enables AI coding assistants to expose local development servers to the public internet through secure tunnels. By integrating with Claude Code and Codex, this skill allows agents to create public HTTPS URLs for local HTTP, TCP, and WebSocket services during development workflows. The skill leverages the Portr tunneling infrastructure, which uses SSH remote port forwarding under the hood, and provides agents with access to request inspection, replay capabilities, and local database logging for debugging sessions.
Key Features
Use Cases
- 01AI agents exposing local development servers for webhook testing and integration demos
- 02Automated debugging workflows where agents inspect and replay HTTP requests captured during tunnel sessions
- 03Collaborative development sessions where AI assistants share localhost services with remote team members
- 04WebSocket application development with agent-assisted connection monitoring and frame inspection
- 05API integration testing where agents expose local endpoints for external service callbacks
- 06Development workflow automation with AI agents managing tunnel creation and log analysis
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
portr — FAQ
What is the portr-cli agent skill?+
Portr-cli is an agent skill for Claude Code and Codex that enables AI coding assistants to expose local development servers to the public internet through secure tunnels. It provides agents with capabilities to create public URLs, inspect requests, and access logging data for HTTP, TCP, and WebSocket services.
How do I install the portr-cli skill for Claude Code?+
Install the skill using the Vercel Labs skills command: npx skills add amalshaji/portr --skill portr-cli -a claude-code -a codex -y. For global installation across all projects, add the -g flag to the command.
Which AI agents support the portr-cli skill?+
The portr-cli skill is designed for Claude Code and Codex agents that support the Vercel Labs skills framework. Both agents can install and use the skill through the npx skills command.
Do I need a Portr server to use this skill?+
Yes, you need access to a Portr server instance—either by setting up your own server or using an existing one. The Portr client must also be installed on your local machine for the skill to create tunnels.
Is the portr-cli skill free to use?+
The skill and Portr software are open source under the GNU AGPL-3.0 license, making them free to use. However, you'll need to deploy or access a Portr server, which may incur infrastructure costs depending on your hosting choice.
Can agents access request logs and inspection data?+
Yes, agents can query logs using the portr logs command with filtering options, and logs are persisted to a local SQLite database at ~/.portr/db.sqlite. The skill also provides JSON output format for programmatic access to stored request data.
How do I install portr?+
Open the source repository on GitHub and follow its README. portr is a skill — MCP Agents Market links you directly to the official repo.
Is portr free?+
portr is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.