truenas-skill
by anotb
Browser & AutomationBrief
Manage TrueNAS SCALE via API.
Description
What This Skill Does
Manages TrueNAS SCALE storage servers via REST and WebSocket APIs. Handles pool health, datasets, snapshots, active alerts, services, and app lifecycle. Includes Dockge integration for Docker Compose stacks and reference configs for homelab services like Sonarr, Radarr, and Plex.
Combines TrueNAS API management, Dockge stack control, and reference integrations for a dozen homelab services in one skill, replacing a collection of separate shell scripts.
When to Use It
- Checking ZFS pool health after a disk replacement
- Taking a manual snapshot before upgrading an app
- Updating all running Dockge container stacks at once
- Reviewing active TrueNAS alerts and replication task status
- Listing which installed apps have updates available
Example Workflow
User asks: Check my NAS health
- 1
Query all pools via TrueNAS API and check the healthy field on each
- 2
Fetch active alerts and extract level and formatted message fields
- 3
List services currently in RUNNING state
- 4
Check which apps have upgrade_available set to true
- 5
Retrieve replication task states
Summary showing each pool's health, any active alerts with severity levels, and a list of apps with pending upgrades
Requirements
- TRUENAS_URL: base URL of your TrueNAS SCALE instance (e.g., https://10.0.0.5:444)
- TRUENAS_API_KEY: API key generated in TrueNAS UI under System > API Keys
Installation
clawhub install anotb/truenas-skillRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.