Skip to content

Add per-workspace port forwarding configuration#45

Merged
gricha merged 2 commits intomainfrom
feat/port-forwarding-config
Jan 8, 2026
Merged

Add per-workspace port forwarding configuration#45
gricha merged 2 commits intomainfrom
feat/port-forwarding-config

Conversation

@gricha
Copy link
Copy Markdown
Owner

@gricha gricha commented Jan 8, 2026

Summary

  • Add perry ports <name> [ports...] CLI command to configure ports per workspace
  • Update perry proxy to use configured ports when none specified
  • Add Port Forwarding card to workspace settings in Web UI
  • Ports persist in workspace state and are used automatically

Usage

CLI:

perry ports myproject              # Show configured ports
perry ports myproject 3000 5173    # Configure ports

perry proxy myproject              # Uses configured ports automatically
perry proxy myproject 8080         # Override with specific port

Web UI:
Workspace Settings tab → Port Forwarding section

Test plan

  • All 108 integration tests pass
  • All 21 web UI tests pass
  • Manual testing: perry ports saves and retrieves ports
  • Manual testing: perry proxy uses configured ports

🤖 Generated with Claude Code

- Add `perry ports <name> [ports...]` command to configure ports per workspace
- Update `perry proxy` to use configured ports when none specified
- Add Port Forwarding card to workspace settings in Web UI
- Ports persist in workspace state and are used automatically

CLI usage:
  perry ports myproject 3000 5173  # Configure ports
  perry proxy myproject            # Uses configured ports

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Comment thread src/agent/router.ts
Comment on lines +278 to 286
.handler(async ({ input }) => {
try {
return await ctx.workspaces.setPortForwards(input.name, input.forwards);
} catch (err) {
mapErrorToORPC(err, 'Failed to set port forwards');
}
});

const getInfo = os.handler(async () => {

This comment was marked as outdated.

Validate port numbers are in valid range 1-65535 at the API boundary,
matching CLI and UI validation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@gricha gricha merged commit 5531c08 into main Jan 8, 2026
6 checks passed
@gricha gricha deleted the feat/port-forwarding-config branch January 8, 2026 04:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant