Midaz CLI (seer-q)

Query CLI for the 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:

curl -fsSL https://raw.githubusercontent.com/SparkssL/Midaz-cli/main/install.sh | sh

Windows (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

npm install -g @midaz/cli
seer-q setup all --yes

From source

git clone https://github.com/SparkssL/Midaz-cli.git
cd Midaz-cli
make install
seer-q setup all --yes

Quick Start

Human Users

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:

curl -fsSL https://raw.githubusercontent.com/SparkssL/Midaz-cli/main/install.sh | sh

Or install skills separately after installing the CLI:

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 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

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 - full command documentation
• Target Compatibility - agent platform setup
• Release Gate - QA checklist
• Changelog

License

MIT