Nebula CLI

Use Nebula from your terminal, coding agent, shell scripts, or CI workflows.

Install

The CLI requires Node.js 18 or later.

npm install --global @hiddensystems/nebula-cli

Confirm the command is available:

nebula --version

Save a key from the API Portal:

nebula auth login --key YOUR_API_KEY

The CLI stores it in ~/.nebula/config.json with owner-only permissions. Run nebula auth logout to remove it.

`nebula tokens search bitcoin`	Search tokens
`nebula tokens trending`	List trending tokens
`nebula accounts vitalik`	Search tracked accounts
`nebula token intelligence bitcoin`	Read token narratives and intelligence
`nebula token mindshare bitcoin`	Read token attention over time
`nebula token sentiment bitcoin`	Read sentiment and cohorts
`nebula token momentum bitcoin`	Read social activity by cluster
`nebula ask "What is trending?"`	Ask the Nebula agent

Add --json to any data command for structured output that agents and scripts can parse.

nebula --json tokens trending
nebula --json token sentiment bitcoin --hours 24
nebula --json token intelligence solana

Print ready-to-use Claude Code and Cursor configuration:

nebula mcp
nebula mcp --json

See the MCP documentation for setup and tool details.

Use environment variables in headless environments instead of writing a local config file.

NEBULA_API_KEY=YOUR_API_KEY nebula --json tokens trending

Use NEBULA_API_BASE_URL only when pointing the CLI at a development or self-hosted API. Store keys in your platform's secret manager.