pi-admin

# Raspberry Pi Administration Complete system monitoring and introspection for the Raspberry Pi host. Access network details, system resources, storage, services, and more. ## When to Use - Checking Pi network configuration (IP, Tailscale) - Monitoring system resources (CPU, memory, storage) - Viewing running services and their status - Checking temperature and hardware info - Troubleshooting system issues - Getting system overview for debugging ## Usage ```bash # Information Commands cd /home/srose/clawd/skills/pi-admin ./skill.sh overview ./skill.sh network ./skill.sh tailscale ./skill.sh resources ./skill.sh storage ./skill.sh services ./skill.sh hardware # Maintenance Commands ./skill.sh update # Update system packages ./skill.sh clean # Clean unused packages, logs, Docker ./skill.sh reboot # Reboot with countdown ./skill.sh restart-gateway # Restart the Clawdis Gateway # Complete system info ./skill.sh all ``` ## Tools Available | Tool | Description | |------|-------------| | `overview` | Quick system summary | | `network` | IP addresses, hostname, network interfaces | | `tailscale` | Tailscale status, IP, peers | | `resources` | CPU, memory, temperature | | `storage` | Disk usage, mount points | | `services` | Running services, Gateway status | | `hardware` | CPU info, Raspberry Pi model, GPU | | `all` | Complete detailed dump | ## Examples ```bash # Quick system check ./skill.sh overview # Debug network issues ./skill.sh network && ./skill.sh tailscale # Check if Gateway is running ./skill.sh services | grep gateway # Monitor disk space ./skill.sh storage ``` ## Information Collected **Network:** - Hostname - Local IP addresses (eth0, wlan0) - Network interface details - DNS configuration **Tailscale:** - Status (running/stopped) - Tailscale IP - Connected peers - Exit node status **Resources:** - CPU usage - Memory usage (used/free/total) - CPU temperature - Uptime **Storage:** - Disk usage by mount point - Inode usage - Free space **Services:** - Gateway service status - Docker containers - Systemd services - Port listeners **Hardware:** - CPU model and cores - Raspberry Pi model - GPU memory - Total RAM ## Maintenance Commands ### `update` Update system packages via apt: - Updates package lists - Shows upgradable packages - Requires confirmation before upgrading - Reports if reboot is needed - **Dry run:** `./skill.sh update --dry-run` shows what would be updated ### `clean` Clean up system to free disk space: - Removes unused packages (autoremove) - Clears package cache - Cleans old journal logs (keeps 7 days) - Optionally cleans Docker artifacts - Shows space saved - **Dry run:** `./skill.sh clean --dry-run` shows what would be cleaned ### `reboot` Graceful system reboot: - 10-second countdown - Ctrl+C to cancel - Uses systemctl reboot - **Dry run:** `./skill.sh reboot --dry-run` shows countdown without rebooting ### `restart-gateway` Restart the Clawdis Gateway service: - Stops all running gateway processes - Starts fresh gateway on port 18789 - Confirms port is listening - Shows access URLs - **Dry run:** `./skill.sh restart-gateway --dry-run` shows what would happen ### `optimize` Apply safe system optimizations: - Disable Bluetooth service (~50MB RAM saved) - Disable ModemManager (~30MB RAM saved) - Disable Avahi/Zeroconf (~20MB RAM saved) - Set swappiness to 10 (better RAM utilization) - **Dry run:** `./skill.sh optimize --dry-run` shows what would change - **Undo:** `./skill.sh optimize --undo` reverts all changes **Total RAM savings:** ~100MB **Reversibility:** Yes, use `--undo` flag to revert **Note:** All maintenance commands require sudo and ask for confirmation before making changes. Use `--dry-run` flag to preview changes without applying them.