Files
nixos-setup/bin/ABOUTME.md
T
2026-10-11 00:39:24 -04:00

7.9 KiB

bin/

The skyg CLI — the single entry point for all system management tasks in this repo.

Structure

bin/
├── skyg                    # Bash shim: exec nu --commands "use lib/cmds.nu *; skyg $*"
├── check-flake-versions    # Bash shim for `skyg check-flake-versions`
├── temp-monitor            # NuShell script: collect CPU/GPU temps to CSV + optional graph
├── TEMP_MONITOR_README.md  # Usage docs for temp-monitor
└── lib/
    ├── cmds.nu    # All subcommand implementations (NuShell — source of truth); commands only
    ├── helpers.nu # Shared helpers: REPO_ROOT const + internal functions used by commands
    ├── profile.nu # Profile helpers and tab-completion data
    └── types.nu   # Type definitions + tab-completion data

Key Commands

Command Description
skyg os switch Rebuild and switch local system
skyg remote switch <host> Deploy to a remote host
skyg remote install <host> Fresh-install a remote host via nixos-anywhere, using hosts/<profile>.disko.nix. Always wipes the disks in that file. Aborts if the file is missing, if the host already boots NixOS from disk (unless --force-wipe), or if you do not type the short hostname.
skyg hm switch Apply Home Manager config
skyg update [input] Update flake inputs
`skyg build-image iso pi1
skyg openwrt Deploy OpenWrt config
skyg rollback Roll back to previous generation
skyg profiles List valid local/remote profiles
skyg check Run nix flake check --no-build
skyg check-flake-versions Verify NixOS release version consistency in flake.nix
skyg remote boot-all Boot all remote hosts (builds on fwdesk)
skyg remote status Check status of all remote hosts
skyg remote reboot-pending Reboot every remote host with a pending reboot (booted-system != current-system). Lists them, asks for confirmation, then reboots one at a time, waiting for each to come back online and sending a desktop notification when it does.
skyg secrets List known secret names
skyg decrypt <secret> Decrypt a secret to .tmp/unencrypted-<secret>
skyg encrypt <secret> [--yaml] Encrypt a working copy back into the secret
skyg compare-secret <secret> Diff the working copy against the stored secret
skyg ca init Generate the lab root CA: key → secrets/lab-ca-key.age, cert → configs/pki/lab-ca.crt (see configs/pki/ABOUTME.md)
skyg ca issue <domain> --for <host> Mint a TLS leaf cert signed by the lab CA: cert → configs/pki/<domain>.crt, key → secrets/<name>-tls-key.age. Auto-registers missing secrets.nix entries.
skyg render html-tpl <file> Render a Gitea .tmpl (swaps base/head/base/footer for a minimal shell, strips {{ … }}) and serve it on 127.0.0.1 for preview. Foreground — Ctrl+C to stop. <file> tab-completes from **/*.tmpl.

Agent Note

Never invoke skyg commands that trigger builds or switches. Only the user runs these. Edits to cmds.nu are safe if the user asks for CLI changes.