npm package: @midaz/cli
Description: Seer Market Intelligence CLI
Latest version: 0.5.0

# Midaz CLI (`seer-q`)

Query CLI for the [Seer](https://github.com/SparkssL/Seer) market intelligence system. It retrieves structured, evidence-backed market analysis from the Seer API.

## Why seer-q?

- **Structured market intelligence** - topics, threads, claims, snapshots, and global regime verdicts
- **Agent-native** - 3 skills bundled in the binary, installed via `seer-q setup`
- **JSON envelope output** - machine-readable responses with `view_url` links, exit codes, and error hints
- **Single binary** - Go, cross-platform, zero runtime dependencies

## Installation

### One-line install (recommended)

**macOS / Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/SparkssL/Midaz-cli/main/install.sh | sh
```

**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/SparkssL/Midaz-cli/main/install.ps1 | iex
```

This installs the `seer-q` binary and runs `seer-q setup all --yes` to install skills for all supported agents.

### From npm

```bash
npm install -g @midaz/cli
seer-q setup all --yes
```

### From source

```bash
git clone https://github.com/SparkssL/Midaz-cli.git
cd Midaz-cli
make install
seer-q setup all --yes
```

## Quick Start

### Human Users

```bash
seer-q search "AI regulation"       # Fuzzy search topics, threads, assets
seer-q market                       # Global regime + all topics
seer-q topic <id>                   # Topic detail + threads
seer-q thread <id>                  # Thread detail + claims + market links
seer-q snapshot                     # Latest global regime snapshot
```

All commands return JSON envelopes. Use `--format pretty` for indented output or `--raw` for the raw API response.

### AI Agents

Install CLI + skills with one command:

```bash
curl -fsSL https://raw.githubusercontent.com/SparkssL/Midaz-cli/main/install.sh | sh
```

Or install skills separately after installing the CLI:

```bash
seer-q setup all --yes          # Install to all agent directories
seer-q setup claude --yes       # Claude Code only
seer-q setup auto --yes         # Detected agents only
```

Skills provide structured guidance for querying the Seer API. See [target compatibility](docs/target-compatibility.md) for platform-specific notes.

## Skills

| Skill | Description |
|-------|-------------|
| `seer-shared` | Response format, config, and common rules |
| `seer-market` | Search, browse, and analyze topics, threads, and claims |
| `seer-api-explorer` | Discover commands via schema introspection |

## Development

```bash
make build       # Build seer-q binary
make test        # Run all Go tests
make qa          # Tests + skills validation + smoke test
make release     # Cross-platform build via goreleaser
make install     # Install to /usr/local/bin (or PREFIX)
```

## Links

- [CLI Reference](docs/cli-reference.md) - full command documentation
- [Target Compatibility](docs/target-compatibility.md) - agent platform setup
- [Release Gate](docs/release-gate.md) - QA checklist
- [Changelog](CHANGELOG.md)

## License

[MIT](LICENSE)