SSH Remote Connection

Universal skill for connecting to remote servers via SSH.

Usage

# Interactive shell
scripts/connect.sh

# Run command directly
scripts/connect.sh "docker compose logs backend --tail 50"

Setup

For Claude Code (local)

1. Copy config template:

``bash cp config/.env.example config/.env ``

1. Fill in config/.env with actual values

Key-based authentication: ``bash SSHHOST=your-server.example.com SSHUSER=ubuntu SSHAUTHMETHOD=key SSHKEYPATH=/absolute/path/to/private/key SSHKEYPASSWORD= SERVERPROJECTPATH=/path/to/project ``

Password-based authentication: ``bash SSHHOST=your-server.example.com SSHUSER=ubuntu SSHAUTHMETHOD=password SSHPASSWORD='your account password' SERVERPROJECT_PATH=/path/to/project ``

1. Make script executable:

``bash chmod +x scripts/connect.sh ``

For Cloud Runtime

Set environment variables in your cloud configuration:

• SSH_HOST — server hostname or IP
• SSH_USER — SSH username
• SSH_PORT — SSH port (optional)
• SSHAUTHMETHOD — auto, key, or password (optional, defaults to auto)
• SSHKEYPATH — path to private key for key authentication
• SSHKEYPASSWORD — key passphrase (optional)
• SSH_PASSWORD — SSH account password for password authentication
• SERVERPROJECTPATH — project directory on server

For password authentication, the local runtime must have either sshpass or expect. If the host key is not trusted yet, connect once manually or add the host to known_hosts before running non-interactive commands.

Important Notes

• Git operations: Do NOT run git pull on the server. User will handle git sync manually.
• Code location: Code is in a private repo, changes must be pushed first then pulled by user.
• Docker: Use docker compose (not docker-compose) on the server.

Example Commands

# View logs
scripts/connect.sh "docker compose logs backend --tail 100"

# Restart service
scripts/connect.sh "docker compose restart backend"

# Rebuild and restart
scripts/connect.sh "docker compose build backend && docker compose up -d backend"

# Check status
scripts/connect.sh "docker compose ps"