Get Started

CLI and Agent Skills Setup

Written by , Product docsLast updated

Hive's local CLI setup is separate from MCP client registration. Use the CLI to store local credentials, inspect health, and print client-specific setup output; use the per-client install guides to add Hive MCP to Claude, Cursor, VS Code, Windsurf, Codex, Gemini, or OpenAI Responses API.


Run the CLI setup wizard

The published npm package is hive-intelligence and currently requires Node 20 or higher. Its CLI binary is hive, so one-off npx commands should use -p:

bash
npx -y -p hive-intelligence@latest hive init --all --browser

The current published CLI (hive-intelligence 1.1.4) supports:

bash
hive init
hive init --all
hive init --browser
hive init --skip-skills
hive init --skip-verify
hive init --minimal
hive init --dry-run
hive init --api-url https://mcp.hiveintelligence.xyz

hive init --all --browser is the full local setup path: it opens the browser auth flow where available, configures local CLI credentials, and installs supported local agent resources. For a smaller setup, use hive init --minimal. For MCP client registration details, choose the client you want from the install index.


After the CLI is available, print the config shape for the client you are configuring:

bash
hive config claude-desktop
hive config cursor
hive config vscode
hive config claude-code
hive config http https://mcp.hiveintelligence.xyz/mcp

Those commands print instructions or JSON for the target client. Compare the output with the dedicated client guide before applying it, because each client handles HTTP transport, headers, and config file scope differently.


Client setup guides

  • Claude Desktop - use Claude's Custom Connectors UI for remote MCP; stdio config is the fallback.
  • Claude Code - use claude mcp add with HTTP or stdio.
  • Cursor - add Hive in Cursor MCP settings or config.
  • VS Code - use Copilot Chat MCP server config.
  • Windsurf - add Hive to mcp_config.json.
  • OpenAI Responses API - use server-side remote MCP or REST; ChatGPT app UI setup may require an OAuth-compatible proxy.
  • Codex CLI - add Hive to Codex MCP config.
  • Gemini CLI - add Hive to Gemini settings.

What are Hive agent skills?

A skill is a Markdown instruction pack an AI agent can read before using a service. Hive's skill pack teaches agents how to install Hive, pick the right task toolset, inspect schemas, call tools safely, and report current crypto data without guessing from stale training data.

Hive publishes skills in four places:

SourceUse it for
npx skills add hive-intel/hive-skillsInstall all public Hive skills into a supported agent environment
npx skills add hive-intel/hive-skills --skill hive-token-diligence --yesInstall one focused Hive workflow skill
hive://skillsRuntime skill metadata during an MCP session
/skills/index.jsonPublic JSON mirror for crawlers and non-MCP agents
/skills/*.mdHuman-readable Markdown mirrors
/agent-onboarding/SKILL.mdAgent install-path decision tree

Runtime MCP clients should prefer hive://skills because it comes from the live server session.

The public installable mirror is github.com/hive-intel/hive-skills. To inspect it before installing, run:

bash
npx skills add hive-intel/hive-skills --list

Verify local CLI setup

bash
hive doctor
hive status

hive doctor checks Node, network access, and Hive server connectivity. hive status confirms the active CLI profile and authentication state.

You can also verify the live REST catalog directly:

bash
curl -X GET "https://mcp.hiveintelligence.xyz/api/v1/tools?limit=5" \
  -H "Authorization: Bearer YOUR_HIVE_API_KEY"

Remove local setup

Use the current uninstall command to remove Hive MCP entries and copied skill packs:

bash
hive uninstall --all
hive uninstall --dry-run

Then clear local CLI credentials:

bash
hive auth logout

If you installed the package globally, remove the binary with your package manager:

bash
npm uninstall -g hive-intelligence