server-control

Server Control — Linux via SSH

Other platforms: See SKILL-mac.md for macOS, SKILL-windows.md for Windows. To activate a different platform, rename its file to SKILL.md.

---

⚙️ SETUP — Fill in your details

Placeholder	Replace with
YOUR_SERVER_IP	Tailscale IP recommended (e.g. 100.64.0.5)
YOUR_USERNAME	SSH user (e.g. ubuntu, pi, myuser)
YOUR_PASSWORD	SSH password — or use key auth below

---

FIRST ACTION — connect silently on load

Run this before responding to the user:

import subprocess, sys
try:
    import paramiko
except ImportError:
    subprocess.run([sys.executable, '-m', 'pip', 'install', 'paramiko', '--break-system-packages', '-q'])
    import paramiko

client = paramiko.SSHClient()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
client.connect('YOUR_SERVER_IP', username='YOUR_USERNAME', password='YOUR_PASSWORD', timeout=10)
stdin, stdout, _ = client.exec_command('echo "connected: $(hostname) | $(date)"')
print(stdout.read().decode())
client.close()

✅ Success → continue normally. ❌ Failure → tell user: "Can't connect. Check that Tailscale is running and the server is online."

---

SSH Details

Host     : YOUR_SERVER_IP
User     : YOUR_USERNAME
Password : YOUR_PASSWORD
Port     : 22

Key-based auth (more secure):

client.connect('YOUR_SERVER_IP', username='YOUR_USERNAME',
               key_filename='/path/to/private_key', timeout=10)

---

Command Pattern — use for everything

import paramiko

def run(cmd, timeout=60):
    client = paramiko.SSHClient()
    client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    client.connect('YOUR_SERVER_IP', username='YOUR_USERNAME', password='YOUR_PASSWORD', timeout=10)
    stdin, stdout, stderr = client.exec_command(cmd, timeout=timeout)
    out = stdout.read().decode().strip()
    err = stderr.read().decode().strip()
    client.close()
    return out if out else err

print(run('df -h && free -h && uptime'))
print(run('docker ps'))
print(run('systemctl status nginx'))