Commands

Global Options

All hive commands accept the following options:

hive [-h] <command>

`hive init`

Initialize the Hive configuration. Prompts for your organisation ID and writes it to ~/.hive/config.yaml.

hive init [-h]

hive login [-h]

`hive logout`

Log out and clear stored credentials for the currently configured organisation.

hive logout [-h]

`hive create experiment`

Create a new experiment from the configuration file. Aliases: hive create exp

hive create experiment [-h] -c CONFIG [--dry-run] [overrides ...]

Argument / Option	Description
`--config`, `-c`	Path to the experiment config file (required)
`--dry-run`	Validate the config and CLI invocation without creating the experiment
`overrides`	Zero or more `key=value` dot-notation overrides applied on top of the YAML (see below)

Overrides let you tweak config values without editing the file:

hive create exp -c hive.yaml \
  experiment_name=foo- \
  repo.branch=feature/try-hive \
  sandbox.resources.cpu=1

Use ~key.path to delete a key (restoring the Pydantic field default):

hive create exp -c hive.yaml ~prompt.context

`hive shell`

Open an interactive shell in a sandbox and attach to it. Useful for reproducing an evaluation environment, debugging a setup script, or inspecting the code at a specific iteration. The command requires an interactive terminal and an authenticated session (--no_auth is not supported). There are two mutually exclusive forms:

hive shell [-h] (-c CONFIG | --exp EXPERIMENT --content-uid UID)
           [--max-duration SECONDS] [--allow-missing-files]

Argument / Option	Description
`--config`, `-c`	Path to a config file whose `sandbox` (and uploaded source) to use. Mutually exclusive with `--exp`/`--content-uid`
`--exp`	Experiment name whose content snapshot to reproduce. Requires `--content-uid`
`--content-uid`	Content snapshot identifier (a point on the evolution chart), scoped to `--exp`. The sandbox is reproduced server-side with that content’s source overlaid
`--max-duration`	Maximum shell duration in seconds (default: `3600`)
`--allow-missing-files`	Skip file-existence validation for `target_code`/`additional_context`/`evaluation_script`/`aggregation_script` (e.g. when the base image supplies them)

# Spin up a sandbox from a local config
hive shell -c hive.yaml

# Reproduce the sandbox at a specific iteration's content snapshot
hive shell --exp my-experiment-abc123 --content-uid 9f3c1e2a

You don’t have to build the --exp/--content-uid command by hand. Select a point on the experiment’s evolution chart in the dashboard and copy the ready-made hive shell command for that snapshot.

In content-snapshot mode the sandbox is reproduced from stored experiment state, so config overrides are rejected.

`hive list experiments`

List all experiments for the current organisation. Aliases: hive list exp, hive list exps

hive list experiments [-h]

`hive list coordinators`

List coordinator configurations. Aliases: hive list coords

hive list coordinators [-h]

To choose how much effort an experiment spends, use agents.preset rather than a coordinator config. The low-effort-config, medium-effort-config and high-effort-config entries are deprecated in favour of the low-effort, medium-effort and high-effort presets.

`hive list models`

List the models an agent ensemble can name in agents.models. Aliases: hive list model

hive list models [-h]

`hive list image`

List pushed sandbox images. Aliases: hive list images

hive list image [-h]

`hive get experiment`

Get detailed information about a specific experiment. Aliases: hive get exp

hive get experiment [-h] <name>

Argument / Option	Description
`name`	Name of the experiment

`hive get config`

Get the stored config (hive.yaml + command line) for an experiment.

hive get config [-h] <name>

Argument / Option	Description
`name`	Name of the experiment

`hive stop experiment`

Stop one or more running experiments. Aliases: hive stop exp

hive stop experiment [-h] [-y] <name> [name ...]

Argument / Option	Description
`name`	Name(s) of the experiment(s) to stop
`--yes`, `-y`	Skip confirmation prompt (only prompted when stopping more than one experiment)

`hive logs`

Stream logs for an experiment. By default the logs are followed live; pass --no-follow to print the existing logs and exit.

hive logs [-h] [--source {all,coordinator,sandbox}] [--worker WORKER] [--no-follow] <name>

Argument / Option	Description
`name`	Name of the experiment
`--source`	Log source: `all`, `coordinator`, or `sandbox` (default: `all` — coordinator + sandbox 0)
`--worker`	Sandbox worker index (0-based, default: `0`) or `all`. Not valid with `--source=coordinator`
`--no-follow`	Print existing logs without following

# Follow both coordinator and sandbox 0 (the default)
hive logs my-experiment-abc123

# Print the existing logs for sandbox worker 0 and exit
hive logs my-experiment-abc123 --source sandbox --worker 0 --no-follow

`hive push image`

Push a locally-built Docker image to the Hive registry so it can be referenced as a sandbox.base_image.

hive push image [-h] [--sync-config CONFIG] <local> <remote>

Argument / Option	Description
`local`	Local image reference to push (e.g. `myapp:dev`)
`remote`	Remote image reference in `hive:{short}:{tag}` form (e.g. `hive:myapp:latest`)
`--sync-config`	After pushing, pin `sandbox.base_image` in `CONFIG` to the pushed image’s digest (`hive:{short}:{tag}@{digest}`), preserving the rest of the file

# Build locally, then push to the Hive registry
docker build -t myapp:dev .
hive push image myapp:dev hive:myapp:latest

# Push and pin the resulting digest into your config
hive push image myapp:dev hive:myapp:latest --sync-config hive.yaml

`hive delete image`

Delete a pushed sandbox image. Aliases: hive delete images

hive delete image [-h] [--all] <image>

Argument / Option	Description
`image`	Image to delete as `{name}:{tag}`, or `{name}` with `--all`
`--all`	Delete every version of `{name}`

`hive skills install`

Install the bundled coding-agent skills into an agent’s skills directory. With no agent named and without --all, prompt an interactive menu. Re-running overwrites the destination, so it doubles as an update.

hive skills install [-h] [--all] [AGENT ...]

Argument / Option	Description
`AGENT`	Agents to install for: `gemini`, `antigravity`, `claude`, `codex`
`--all`	Install for every supported agent

Agent	Skills directory
`gemini`, `antigravity`	`~/.gemini/config/skills`
`claude`	`~/.claude/skills`
`codex`	`~/.agents/skills`

# Pick agents from an interactive menu
hive skills install

# Install for every supported agent
hive skills install --all

# Install for specific agents
hive skills install claude codex

`hive dashboard`

Open the Hive dashboard in a browser window.

hive dashboard [-h] [--no-browser]

Option	Description
`--no-browser`	Print the dashboard URL to stdout without opening a browser

`hive diagnostics`

Run diagnostics to identify common problems with hivekit, such as connection and authentication issues.

hive diagnostics

Getting started

Using the Hive

Releases

Global Options

`hive init`

`hive logout`

`hive create experiment`

`hive shell`

`hive list experiments`

`hive list coordinators`

`hive list models`

`hive list image`

`hive get experiment`

`hive get config`

`hive stop experiment`

`hive logs`

`hive push image`

`hive delete image`

`hive skills install`

`hive dashboard`

`hive diagnostics`

​Global Options

​hive init

​hive login

​hive logout

​hive create experiment

​hive shell

​hive list experiments

​hive list coordinators

​hive list models

​hive list image

​hive get experiment

​hive get config

​hive stop experiment

​hive logs

​hive push image

​hive delete image

​hive skills install

​hive dashboard

​hive diagnostics

Global Options

`hive init`

`hive login`

`hive logout`

`hive create experiment`

`hive shell`

`hive list experiments`

`hive list coordinators`

`hive list models`

`hive list image`

`hive get experiment`

`hive get config`

`hive stop experiment`

`hive logs`

`hive push image`

`hive delete image`

`hive skills install`

`hive dashboard`

`hive diagnostics`