terminal-tunnel-stop

Stop an active SSH tunnel by its unique tunnel ID.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to cleanly stop and remove active SSH tunnels that are no longer needed, preventing resource leaks and ensuring a tidy terminal environment.

Core Features & Use Cases

  • Tunnel Management: Gracefully terminates established SSH port-forwarding tunnels.
  • Resource Cleanup: Frees up local ports and server resources used by tunnels.
  • Use Case: After completing a remote debugging session that required a tunnel, use this Skill to shut down the tunnel, ensuring the port is available for other applications.

Quick Start

Stop the SSH tunnel with the ID 'tunnel-abc123'.

Frequently Asked Questions about terminal-tunnel-stop

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

FAQPage Schema
How do I stop an active SSH tunnel to free up a local port?

To stop an SSH tunnel, you need the unique tunnel ID obtained from the tunnel creation operation. Providing this ID gracefully terminates the port forwarding session, freeing the local port for other applications.

When should I clean up an SSH port forwarding session?

You should clean up an SSH port forwarding session when the forwarded service is no longer required or a remote task is completed. This prevents resource leaks and maintains a tidy terminal environment.

How does closing an SSH tunnel affect local resources?

Closing an SSH tunnel frees up local ports and server resources that were allocated during forwarding. This ensures the terminal environment remains tidy and prevents background resource leaks.

Do I need the original tunnel ID to terminate SSH port forwarding?

Yes, you need the original tunnel ID to terminate SSH port forwarding. This unique identifier, obtained from the previous tunnel creation operation, is required to cleanly stop the specific active connection.

What is the best way to manage SSH tunnels after remote debugging?

The best way to manage SSH tunnels after remote debugging is to gracefully shut down the active connection using its unique tunnel ID. This ensures the forwarded port is immediately available for other applications.

Why does my SSH tunnel remain active after my task is completed?

An SSH tunnel remains active after a task is completed because it requires explicit cleanup to terminate. You must stop the tunnel using its unique tunnel ID to prevent resource leaks.