cleaner cli + pkg update
This commit is contained in:
1 parent
58e0705aca
commit
6fbdcf44cf
19 files changed
+590
-424
No files matched your search
+40
-29
@@ -7,42 +7,53 @@ The `skyg` CLI — the single entry point for all system management tasks in thi
|
||||
```
|
||||
bin/
|
||||
├── skyg # Bash shim: exec nu --commands "use lib/cmds.nu *; skyg $*"
|
||||
├── check-flake-versions # Bash shim for `skyg check-flake-versions`
|
||||
├── check-flake-versions # Bash shim for `skyg flake check-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
|
||||
├── cmds.nu # Dispatcher + bare `skyg` + `skyg profiles` + deprecated aliases
|
||||
├── os.nu # `skyg os` (local NixOS rebuild/switch/rollback)
|
||||
├── remote.nu # `skyg remote *` (deploy, install, boot-all, status, reboot-pending)
|
||||
├── secrets.nu # `skyg secrets list/show/edit/compare`
|
||||
├── ca.nu # `skyg ca init/issue`
|
||||
├── pkgs.nu # `skyg pkgs update`
|
||||
├── flake.nu # `skyg flake update/check/check-versions`
|
||||
├── build.nu # `skyg build image/openwrt`
|
||||
├── render.nu # `skyg render html-tpl`
|
||||
├── hm.nu # `skyg hm <action>`
|
||||
├── helpers.nu # Shared helpers: REPO_ROOT const + internal functions
|
||||
├── profile.nu # Profile helpers and tab-completion data
|
||||
├── types.nu # Tab-completion completer functions
|
||||
└── remote.utils.nu # Remote-specific helpers (boot info, wait-for-host, notify)
|
||||
```
|
||||
|
||||
## 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 | 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 <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`. |
|
||||
| Command | Description |
|
||||
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `skyg os switch` | Rebuild and switch local system |
|
||||
| `skyg os rollback` | Roll back to previous generation |
|
||||
| `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 remote status <host>` | Check status of a single remote host |
|
||||
| `skyg remote status --all` | Check status of all remote hosts |
|
||||
| `skyg remote boot-all` | Boot 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 hm switch` | Apply Home Manager config |
|
||||
| `skyg flake update [input]` | Update flake inputs |
|
||||
| `skyg flake check` | Run `nix flake check --no-build` |
|
||||
| `skyg flake check-versions` | Verify NixOS release version consistency in flake.nix |
|
||||
| `skyg build image iso\|pi1\|pi2` | Build bootable image — ISO (`iso`) or Pi SD card image (`pi1`, `pi2`) |
|
||||
| `skyg build openwrt [router]` | Deploy OpenWrt config |
|
||||
| `skyg profiles` | List valid local/remote profiles |
|
||||
| `skyg secrets list` | List known secret names |
|
||||
| `skyg secrets show <secret>` | Decrypt a secret to `.tmp/unencrypted-<secret>` |
|
||||
| `skyg secrets edit <secret> [--yaml]` | Encrypt a working copy back into the secret |
|
||||
| `skyg secrets 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 <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 pkgs update [--all\|<pkg>]` | Update one or all custom packages |
|
||||
| `skyg render html-tpl <file>` | Render a Gitea `.tmpl` and serve it on `127.0.0.1` for preview. Foreground — Ctrl+C to stop. `<file>` tab-completes from `**/*.tmpl`. |
|
||||
|
||||
## Agent Note
|
||||
|
||||
|
||||
Reference in new issue
Block a user