CLI Reference

aihummer install
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer license keygen        # generate a signing key
aihummer license sign          # sign a license
aihummer license show          # show the current license

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish: privately (to your instance) or publicly (PR to the catalog)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

The `aihummer` command-line tool manages a host-native install: it installs and updates the gateway, controls the systemd services, runs diagnostics, handles backups, and signs licenses. This page lists every command. ## Commands | Command | What it does | |---|---| | `up` / `install` | Install (or bring up) the gateway and sidecars. | | `update [--check]` | Update to the latest release; `--check` only reports whether an update is available. | | `restart` | Restart the services. | | `stop` | Stop the services. | | `logs [svc]` | Tail logs; pass a service name to filter. | | `status` | Show service status. | | `doctor` | Run diagnostics / health checks. | | `backup [dir]` | Create a backup (optionally into a target directory). | | `restore <file>` | Restore from a backup file. | | `uninstall [flags]` | Remove the install (see flags below). | | `set-password` / `admin-password` | Set the local admin password. | | `license {keygen\|sign\|show}` | Manage licenses (generate key, sign, show). | | `loadtest` | Run a load test against the gateway. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: scaffold, validate, keys, package, sign and publish (private/public). | | `version` | Print the version. | | `help` | Show help. | ### `uninstall` flags | Flag | Effect | |---|---| | `--purge` | Also remove data (full removal). | | `--yes` | Skip the confirmation prompt. | | `--no-backup` | Do not take a backup before removing. | | `--backup-dir <dir>` | Write the pre-uninstall backup to this directory. | ## Usage examples ### Install and bring up ```bash aihummer install aihummer status ``` ### Update ```bash # Only check whether a newer release exists aihummer update --check # Apply the update aihummer update ``` ### Service control and logs ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### Diagnostics ```bash aihummer doctor ``` ### Backup and restore ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres is the source of truth, but your `AIHUMMER_MASTER_KEY` and the blob > directory must be backed up separately — without the master key, encrypted > secrets cannot be recovered. ### Set the admin password ```bash aihummer set-password ``` ### Licenses ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### Load test ```bash aihummer loadtest ``` ### Plugins ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish: privately (to your instance) or publicly (PR to the catalog) aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz aihummer plugin publish --public --dir ./my-plugin --key author.key \ --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \ --description "..." --icon https://you.example/icon.svg ``` For the full SDK and both publishing modes see [Plugin SDK](/en/v1.0/marketplace/sdk) and [Publishing a plugin](/en/v1.0/marketplace/publishing). > [!WARNING] > `aihummer uninstall --purge --yes` removes data and skips the confirmation > prompt. Make sure you have a verified backup first. ## Where to next - Configure what the CLI installs: [Environment variables](/en/v1.0/reference/env-vars). - Decide what tools the agent can use: [Tools catalog](/en/v1.0/reference/tools-catalog).