CLI setupOptional for dashboard users

Install the HiveLang CLI

You can build agents entirely from the Bothive dashboard. Install the CLI when you want file-based agents, local testing, version control, or deployment from a developer workflow.

No install required for the visual path

If you are creating your first bot, start in the dashboard. Use the CLI only when you need a local project and a deploy command.

Install

Add the HiveLang command to your machine.

Authenticate

Link the CLI to your Bothive workspace.

Deploy

Push a tested agent into production.

Prerequisites

Node.js 18 or newer.
A Bothive account and workspace.
An API key from Dashboard → Developer → API Keys.
Any provider keys your agent needs, if you are using bring-your-own-key models or custom tools.

1. Install the CLI

Install HiveLang globally, then verify that the hive command is available.

npm install -g hivelang
hive --version

2. Sign in

Authenticate with an API key from your dashboard. Keep secret keys on your server or local machine only; never ship them in frontend code.

hive login
hive whoami

3. Create a local project

Start a small project, run it locally, and test the behavior before deploying. Your first agent should have one clear job and a small set of approved tools.

hive init "Customer Support Agent"
cd customer-support-agent
hive dev bot.hive

4. Deploy

Deploy after the agent responds correctly, refuses unsafe requests, and produces useful traces when a tool fails.

hive deploy bot.hive

Command reference

hive login	Connect the CLI to your Bothive account.
hive whoami	Confirm which workspace the CLI is using.
hive init <name>	Create a new HiveLang bot project.
hive dev <file>	Run an agent locally while you test behavior.
hive deploy <file>	Deploy the agent into your Bothive workspace.
hive integrations	List available standard integration namespaces.

Troubleshooting

command not found: hive

Your npm global bin is not on PATH. Check npm bin -g, add it to PATH, then restart the terminal.

Permission error during install

Use a Node version manager or configure an npm prefix you own instead of installing with sudo.

Wrong workspace after login

Run hive logout, sign in again, and confirm with hive whoami.

Next step

Continue with the quick start, or jump into HiveLang basics if you want to write the agent by hand.