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

# 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

# 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.