CLI Reference
Command-line tool for building, testing, and deploying agents.
The @open-hive/cli is the unified command-line interface for the OpenHive platform. It streamlines the entire agent development lifecycle—from scaffolding a new project to deploying it to a production cluster.
For the most up-to-date list of commands, flags, and configuration options, please visit the official GitHub repository.
Installation
npm install -g @open-hive/cliCheat Sheet
Here are the most common commands you'll use daily.
Development
| Command | Description |
|---|---|
hive create <name> | Interactive wizard to scaffold a new Node.js or Python agent. |
hive start | Starts the agent in the current directory in development mode. |
hive exec | Interactive client to test and message any running agent. |
hive up | Starts a local instance of the OpenHive Registry for offline development. |
Deployment
| Command | Description |
|---|---|
hive login | Authenticates your session with OpenHive Cloud. |
hive publish | Builds, containers, and deploys your agent to the cloud. |
hive publish --local | Publishes your agent to the local registry (hive up). |
Configuration
| Command | Description |
|---|---|
hive config set <key> <val> | Set global configuration (e.g., registry_url). |
hive whoami | Show the currently logged-in user and active organization. |
Advanced Usage
The CLI is built on oclif and is highly extensible. You can use it to script complex orchestration workflows or integrate it into your CI/CD pipelines.
For detailed flag references (e.g., --json output, --registry overrides), run:
hive --help