# Nebula CLI

Search tokens, inspect market signals, ask Nebula, and configure MCP from your terminal.

## Install

Requires Node.js 18 or later.

```bash
npm install --global @hiddensystems/nebula-cli
```

## Authenticate

```bash
nebula auth login --key YOUR_API_KEY
```

Credentials are stored in `~/.nebula/config.json` with owner-only permissions. Set `NEBULA_API_KEY` for automation.

## Commands

```bash
nebula tokens search bitcoin
nebula tokens trending
nebula accounts vitalik
nebula token intelligence bitcoin
nebula token mindshare bitcoin --hours 24
nebula token sentiment bitcoin --hours 24 --clusters smart_money
nebula token momentum bitcoin --granularity 1h
nebula ask "What narratives are heating up around Solana?"
```

Add `--json` to data commands for script- and agent-friendly JSON. Run `nebula mcp` to print MCP client configuration.