CLI Reference

The hive-intel CLI provides terminal access to all Hive Intelligence data. Install it globally or run with npx.

Installation

npm install -g hive-intel

Or run without installing:

npx hive-intel --help

Requirements: Node.js 20+

Quick Start

# Get Bitcoin price
hive-intel market price --ids bitcoin --vs usd

# Get top coins by market cap
hive-intel market top --vs usd --limit 10

# Check trending coins
hive-intel market trending

# Get stock quote
hive-intel stocks quote --symbol AAPL

# Get US GDP data
hive-intel macro gdp

# Search tools
hive-intel tools search "yield"

Domain Commands

The CLI organizes tools into domain-specific subcommands:

Tool Commands

For direct tool access by name:

# List all tools
hive-intel tools list

# Filter by category
hive-intel tools list --category "Market Data"

# Filter by provider
hive-intel tools list --provider goldrush

# Search tools
hive-intel tools search "yield farming"

# Get tool schema
hive-intel tools info get_price

# Call any tool directly
hive-intel tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'

# Force-refresh the tool catalog cache
hive-intel tools refresh

Configuration

Generate config for different MCP clients:

# Claude Desktop config
hive-intel config claude-desktop

# Cursor config
hive-intel config cursor

# VS Code config
hive-intel config vscode

# Claude Code command
hive-intel config claude-code

# Remote HTTP connection
hive-intel config http

Server Mode

Start the MCP server directly:

# Start stdio server (for Claude Desktop)
hive-intel serve

# Start HTTP server
hive-intel serve --http --port 8080

Authentication

Manage your Hive account and API credentials:

# Create a new Hive account
hive-intel auth signup

# Log in with your Hive API key
hive-intel auth login

# Show current profile
hive-intel auth whoami

# List all profiles
hive-intel auth profiles

# Switch active profile
hive-intel auth switch production

# Log out (remove stored credentials)
hive-intel auth logout

API Key Management

# List your API keys
hive-intel keys list

# Create a new API key
hive-intel keys create --name "Production Key"

# Revoke a key by ID
hive-intel keys revoke key_abc123

Usage & Billing

# Show your API usage and plan limits
hive-intel usage

Health & Diagnostics

# Quick health and version check
hive-intel status

# Diagnose environment and connectivity
hive-intel doctor
hive-intel doctor --probe  # Include live API probes

Utilities

# Interactive setup wizard
hive-intel init
hive-intel init --minimal   # Write defaults without prompts
hive-intel init --dry-run   # Preview changes without writing

# Shell completions
hive-intel completion bash >> ~/.bashrc
hive-intel completion zsh >> ~/.zshrc
hive-intel completion fish >> ~/.config/fish/completions/hive-intel.fish
hive-intel completion bash --install  # Auto-install to shell rc file

# Open dashboard, docs, status, or GitHub in browser
hive-intel open              # Default: dashboard
hive-intel open docs
hive-intel open status

Watch Mode

Poll a tool on a recurring interval:

# Poll Bitcoin price every 30 seconds (default)
hive-intel watch market price --args '{"ids":"bitcoin","vs_currencies":"usd"}'

# Custom interval (every 60 seconds)
hive-intel watch market price --interval 60 --args '{"ids":"bitcoin","vs_currencies":"usd"}'

# Watch gas prices
hive-intel watch network gas --interval 15 --args '{"chain":"eth-mainnet"}'

Aliases

Create command shortcuts for frequently used commands:

# Create an alias
hive-intel alias set btc 'market price --ids bitcoin --vs usd'

# List all aliases
hive-intel alias list

# Remove an alias
hive-intel alias remove btc

# Use an alias
hive-intel btc

Telemetry

Control anonymous usage tracking:

# Check telemetry status
hive-intel telemetry status

# Disable telemetry
hive-intel telemetry disable

# Enable telemetry
hive-intel telemetry enable

Global Options

Examples

Crypto Market Data

# Bitcoin price
hive-intel market price --ids bitcoin --vs usd

# Top gainers/losers
hive-intel market gainers --vs usd

# OHLC candles
hive-intel market ohlc --id bitcoin --days 30

# Gas prices
hive-intel market gas --chain eth-mainnet

DeFi Analytics

# Protocol TVL
hive-intel defi tvl --protocol aave

# All protocols
hive-intel defi protocols

# Yield farming pools
hive-intel defi yields

# Cross-chain bridges
hive-intel defi bridges

Stock Market

# Real-time quote
hive-intel stocks quote --symbol AAPL

# Historical candles
hive-intel stocks candles --symbol AAPL --resolution D --from 1709251200 --to 1711929600

# Analyst recommendations
hive-intel stocks recommendations --symbol TSLA

Economic Calendar

# Economic calendar
hive-intel macro calendar

Security Analysis

# Token security scan
hive-intel security scan --chain 1 --address 0x...

# Rug pull detection
hive-intel security rugpull --chain 1 --address 0x...

# Recent DeFi hacks
hive-intel security hacks

Wallet Analytics

# Multi-chain balances
hive-intel wallet balances --address 0x...

# ERC-20 transfers
hive-intel wallet transfers --address 0x... --chain eth-mainnet

# Token approval audit
hive-intel wallet approvals --address 0x... --chain eth-mainnet

Piping and Scripting

# Pass all args as JSON
hive-intel tools call get_protocols --args '{}' --json

# Built-in jq-style filtering
hive-intel tools search "price" --jq ".[] | .name"

# Pipe JSON via stdin
echo '{"ids":"bitcoin","vs_currencies":"usd"}' | hive-intel tools call get_price

# CSV output for spreadsheets
hive-intel tools call get_coins_market_data --args '{"vs_currency":"usd"}' --csv

# Combine with external jq
hive-intel tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}' --json | jq '.bitcoin.usd'

Related

• API Documentation - REST API reference
• Tools Reference - Complete tool catalog
• Quick Start - Get started in 5 minutes