---
title: CLI and Agent Skills Setup
lastUpdated: '2026-06-03'
nextjs:
  metadata:
    title: Hive CLI and Agent Skills Setup
    description: Set up the Hive CLI, print client-specific MCP config output, and find Hive's public agent skill mirrors.
    alternates:
      canonical: https://www.hiveintelligence.xyz/install/claude-skill
---

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. {% .lead %}

{% ai-doc-actions path="/install/claude-skill" title="CLI and Agent Skills Setup" /%}

---

## 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](/install).

---

## Print client-specific config output

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](/install/claude-desktop) - use Claude's Custom Connectors UI for remote MCP; stdio config is the fallback.
- [Claude Code](/install/claude-code) - use `claude mcp add` with HTTP or stdio.
- [Cursor](/install/cursor) - add Hive in Cursor MCP settings or config.
- [VS Code](/install/vs-code) - use Copilot Chat MCP server config.
- [Windsurf](/install/windsurf) - add Hive to `mcp_config.json`.
- [OpenAI Responses API](/install/chatgpt) - use server-side remote MCP or REST; ChatGPT app UI setup may require an OAuth-compatible proxy.
- [Codex CLI](/install/codex) - add Hive to Codex MCP config.
- [Gemini CLI](/install/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:

| Source | Use it for |
| --- | --- |
| `npx skills add hive-intel/hive-skills` | Install all public Hive skills into a supported agent environment |
| `npx skills add hive-intel/hive-skills --skill hive-token-diligence --yes` | Install one focused Hive workflow skill |
| `hive://skills` | Runtime skill metadata during an MCP session |
| [`/skills/index.json`](/skills/index.json) | Public JSON mirror for crawlers and non-MCP agents |
| [`/skills/*.md`](/skills) | Human-readable Markdown mirrors |
| [`/agent-onboarding/SKILL.md`](/agent-onboarding/SKILL.md) | Agent 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`](https://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
```

---

## Related

- [CLI Reference](/cli) - every Hive CLI command
- [Agent Skills](/skills) - all 17 public skill mirrors
- [All install guides](/install) - per-client MCP setup
- [API Keys](/dashboard/keys) - manage keys in the dashboard
- [Crypto MCP Server](/crypto-mcp) - what the MCP endpoint exposes