​
Overview

gizzi runtime discovers agent CLI executables that are available on a host, registers them as a local runtime entry, and reports their current status. This is useful for cataloging the agents installed on a workstation, CI runner, or remote machine that other Allternit tooling can dispatch work to. A runtime entry records:
  • The host the CLIs were discovered on (localhost by default).
  • Each discovered CLI name, path, and version string.
  • A status of online, busy, or offline.
  • The last heartbeat and registration time.
The runtime registry is maintained in-process while the CLI is running; register a runtime whenever you want an up-to-date inventory of available agent CLIs.

​
Command reference

​
Usage examples

​
List registered runtimes

Output shows one runtime per host, a status icon, the host, and each discovered CLI with its version:

​
Register the local runtime

This discovers CLIs on the local machine and stores them under the default name local.

​
Register a remote host

The first argument is the runtime name; the second is the host identifier. If a runtime already exists for that host, the entry is updated with the latest discovery results.

​
Show registry status

​
Common arguments

The runtime subcommands do not accept additional flags beyond their positional arguments and --help.

​
How discovery works

When you run gizzi runtime register, the CLI resolves known agent CLI executable names through the system PATH and records the first line of their --version output. No network calls are made; discovery is entirely local to the target host. If no agent CLIs are found, the command prints a discovery report and exits without registering anything: