terminal-forward-remote-to-local

Forward a local port to a remote host via SSH tunneling.

19|14|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/X-School-Academy/skill-pilot --skill terminal-forward-remote-to-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-forward-remote-to-local
Source: https://github.com/X-School-Academy/skill-pilot/tree/main/core/skills/system/terminal-forward-remote-to-local
Command: npx skills add https://github.com/X-School-Academy/skill-pilot --skill terminal-forward-remote-to-local

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables secure access to services running on a remote network by establishing an SSH local port-forwarding tunnel, effectively bringing a remote service to your local machine.

Core Features & Use Cases

  • SSH Tunneling: Creates a secure SSH tunnel to forward local ports to remote hosts and ports.
  • Remote Service Access: Ideal for accessing databases, internal APIs, or other services that are behind an SSH gateway or firewall.
  • Use Case: You need to connect to a PostgreSQL database running on a remote server (e.g., db.internal:5432) from your local machine. You can use this Skill to forward a local port (e.g., 5432) to that remote database through an SSH connection to a specified target.

Quick Start

Use the terminal skill to start an SSH local port-forward from local port 5432 to remote host db.internal on port 5432 using the ssh:prod target.

Frequently Asked Questions about terminal-forward-remote-to-local

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I access a remote database through an SSH tunnel from my local machine?

Access a remote database through an SSH tunnel by establishing local port forwarding, which maps a local port to the remote host and port. This securely bridges your local environment to internal network services behind a firewall using a defined SSH target.

What is SSH local port forwarding and when do I need it?

SSH local port forwarding is a mechanism that securely tunnels a local port to a remote host and port via an SSH connection. You need it to access internal network services, such as private APIs or databases, directly from your local development environment.

Do I need an existing SSH config profile to set up local port forwarding?

Yes, you need valid SSH profiles defined in your server's SSH config file. The local port-forwarding tunnel relies on these pre-configured profiles for target authentication and establishing the connection to the specified SSH target.

Can I connect to a remote internal API using a local port?

Yes, you can connect to a remote internal API by forwarding a local port to the remote host and port. This creates a secure SSH tunnel, allowing your local development environment to communicate with the internal API as if it were running locally.

What's the best way to securely access internal network services during development?

The best way to securely access internal network services is by establishing an SSH local port-forwarding tunnel. This method effectively brings the remote service to your local machine by routing traffic through a defined and authenticated SSH target.

Why does my SSH tunnel fail to connect to the remote host?

An SSH tunnel fails to connect if the server lacks valid SSH profiles for target authentication. Ensure your SSH config file contains the correct profile definitions for the specified SSH target, local port, and remote host configuration.