# 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 # Core subcommand implementations (NuShell — source of truth); commands only ├── remote.nu # `skyg remote*` commands (deploy, install, boot-all, status, reboot-pending) ├── 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 ` | Deploy to a remote host | | `skyg remote install ` | Fresh-install a remote host via nixos-anywhere, using `hosts/.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 | pi2` | Build bootable image — ISO (`iso`) or Pi SD card image (`pi1`, `pi2`) | | `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 ` | Decrypt a secret to `.tmp/unencrypted-` | | `skyg encrypt [--yaml]` | Encrypt a working copy back into the secret | | `skyg compare-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 --for ` | Mint a TLS leaf cert signed by the lab CA: cert → `configs/pki/.crt`, key → `secrets/-tls-key.age`. Auto-registers missing `secrets.nix` entries. | | `skyg render html-tpl ` | 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. `` tab-completes from `**/*.tmpl`. | ## Agent Note > **Never invoke `skyg` commands that trigger builds or switches.** > Only the user runs these. Edits to `cmds.nu` / `remote.nu` are safe if the user asks for CLI changes.