- name
- pi-admin
- description
- Raspberry Pi system administration. Monitor resources, manage services, perform updates and maintenance.
- metadata
- {"clawdis":{"emoji":"🥧","requires":{"bins":[]}}}
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 allTools 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 storageInformation 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-runshows 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-runshows what would be cleaned
reboot
Graceful system reboot:
- 10-second countdown
- Ctrl+C to cancel
- Uses systemctl reboot
- Dry run:
./skill.sh reboot --dry-runshows 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-runshows 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-runshows what would change - Undo:
./skill.sh optimize --undoreverts 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.