Files
hermenix/nu/hermenix.nu
T
2026-09-17 15:23:16 -04:00

41 lines
1.6 KiB
Nu

#!/usr/bin/env nu
#
# hermenix — host-side tooling for the Hermes Agent VM.
#
# No local checkout needed. `hermenix` is a flake package meant to be run
# straight from its git+ssh URL:
#
# nix run <flake>#hermenix
#
# Or install once and just call it directly:
#
# nix profile install <flake>#hermenix (or via the nixos-setup overlay)
#
# Host-specific settings (cache signing key, SSH key) live at
# /etc/hermenix/local.nix — see guest/local.nix.example.
#
# Source layout (all concatenated by flake.nix in dependency order):
#
# lib/common.nu output helpers, run-argv, vsock-ssh-args
# lib/guest.nu shared guest-connection env helpers
# host/setup.nu hermenix setup
# host/migrate.nu hermenix migrate
# host/remote.nu hermenix remote
# vm/vm.nu hermenix vm *
# ctl/ctl.nu hermenix ctl *
# hermenix.nu this file — top-level dispatch (main)
def main [] {
print "usage: hermenix <subcommand> ..."
print ""
print " hermenix setup guided host-side setup"
print " hermenix migrate <source> carry an existing flat HERMES_HOME into the guest"
print " hermenix migrate connections <src> <dst> copy only connection files between folder deployments"
print " hermenix remote <host> \"<cmd>\" run setup/migrate on a remote host over SSH"
print ""
print " hermenix vm <subcommand> control the VM (start/stop/console/snapshots/backups)"
print " hermenix ctl <subcommand> drive Hermes inside the guest (identity/config/secrets/gateway)"
print ""
print "run `hermenix vm` or `hermenix ctl` for their full subcommand lists."
}