CLI

May 3, 2026 · View on GitHub

exodata is the terminal client for Exoplanets Catalog. It can query the live API, use downloaded local data offline, and print table, JSON, or CSV output.

Install from crates.io:

cargo install exodata
exodata --help

Install from the repository:

cargo install --path crates/exo-cli
exodata --help

Build without installing:

cargo build -p exodata --release
./target/release/exodata --help

Public Commands

query
rows
schema
insights
download
config
skill
dev

Use --backend api for the live service, --backend local for a complete local dataset, or the default --backend auto to use local data when available and otherwise use the API.

Useful global options:

--backend <auto|api|local>
--api-base-url <URL>
--data-dir <PATH>
--output <table|json|csv>

Query Data

Run SQL:

exodata query "SELECT pl_name, hostname FROM exoplanets LIMIT 10"
exodata query "SELECT pl_name, hostname, disc_year FROM exoplanets ORDER BY disc_year DESC LIMIT 10" --output json

Browse rows:

exodata rows exoplanets --columns pl_name,hostname,disc_year --limit 10
exodata rows stellarhosts --columns hostname,sy_dist,st_teff --sort sy_dist --order asc --limit 10

View schema metadata:

exodata schema exoplanets
exodata schema stellarhosts --output json

Insights

List available insight slugs:

exodata insights list

Run one insight:

exodata insights run smallest-exoplanets-radius
exodata insights run nearest-stellar-hosts --output json

Offline Data

Download the local data bundle:

exodata download all

The default offline data directory is ~/.exodata:

~/.exodata/
|-- stellarhosts.parquet
|-- exoplanets.parquet
|-- stellarhosts-metadata.toml
`-- exoplanets-metadata.toml

Use another directory explicitly:

exodata --backend local --data-dir data schema exoplanets

Config

exodata config path
exodata config get default_backend
exodata config set default_backend local

Agent Skill

Install the Agent Skill for the current project:

exodata skill install local

Install it globally for your user:

exodata skill install global

Local install writes .agents/skills/exodata/SKILL.md under the current directory. Global install writes ~/.agents/skills/exodata/SKILL.md.

Development Commands

Repository maintainers can use exodata dev for VOTable inspection, conversion, local parquet SQL, and bulk insight verification:

exodata dev view-fields data/exoplanets.vot
exodata dev view-metadata --path data/stellarhosts.vot --columns hostname,st_teff,st_mass
exodata dev convert-raw-files --data-dir data
exodata dev sql "SELECT pl_name, hostname FROM exoplanets LIMIT 10" --data-dir data
exodata dev insights run-all --data-dir data

These commands are intentionally grouped away from the public top-level command surface because most third-party users do not need VOTable or data-preparation workflows.