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)
-
Copy config template:
cp config/.env.example config/.env -
Fill in
config/.envwith actual values -
Make script executable:
chmod +x scripts/connect.sh
For Cloud Runtime
Set environment variables in your cloud configuration:
SSH_HOST— server hostname or IPSSH_USER— SSH usernameSSH_KEY_PATH— path to private keySSH_KEY_PASSWORD— key passphrase (optional)SERVER_PROJECT_PATH— project directory on server
Important Notes
- Git operations: Do NOT run
git pullon 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(notdocker-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"