ssh-remote-connection

The ssh-remote-connection skill provides a robust, secure interface for managing remote infrastructure directly from your Claude Code workflow. Designed for developers and DevOps engineers, this tool streamlines common server administration tasks such as monitoring service status, troubleshooting application logs, and orchestrating containerized environments. By leveraging established SSH protocols, it allows you to maintain control over your remote servers without leaving your coding environment.

• Full SSH command execution capabilities, supporting both key-based and password-based authentication methods.

• Docker-centric workflow support, optimized for docker compose operations including logs, restarts, builds, and status checks.

• Agent forwarding support to utilize local SSH keys securely during remote sessions.

• Highly configurable environment settings for host, user, and project path management across different deployment stages.

• Streamlined integration for interactive shells or non-interactive direct command execution, perfect for automated deployment tasks.

• Ensure the environment variable SERVER_PROJECT_PATH is correctly defined to scope commands to your target directory on the remote machine.

• For password-based connections, ensure dependencies like sshpass or expect are available in the local runtime.

• Avoid using this tool for large git operations like git pull; it is intended for command execution and service lifecycle management.

• Use the provided scripts/connect.sh utility as the primary entry point for both interactive and scripted workflows.

• Host keys should be trusted or added to the known_hosts file beforehand to ensure smooth non-interactive command execution.

• Optimized for modern container stacks—use docker compose rather than legacy commands for better container orchestration compatibility.