dekart 0.9.0

Dekart CLI for auth, MCP tool discovery, calls, and file upload flows.

dekart-cli

Dekart MCP wrapper for your AI agent to create maps from SQL query results.

Works best with the geosql skill — it writes the SQL, this CLI renders the map.

Works with any Dekart instance:

• Dekart Cloud (SaaS, default)
• Self-hosted (your own URL)
• Localhost (http://localhost:8080)

Init

pip install dekart
dekart init

dekart init walks you through:

1. Picking the instance (Cloud / self-hosted / localhost).
2. Authorizing the CLI in your browser.
3. Optionally enabling local snapshots.

To switch instance later:

dekart config --url <your-url>
dekart init

Config and token: ~/.config/dekart/.

Enable local snapshot

Local headless renderer for fast PNG snapshots without a round-trip to the server:

dekart snapshot-local install

Manage:

dekart snapshot-local status
dekart snapshot-local uninstall          # remove renderer
dekart snapshot-local uninstall --purge  # also remove its browser cache

When local snapshot is enabled, dekart snapshot --report-id <id> --out ./snap.png uses it automatically. Pass --remote-only to force server-side rendering.

Run Query And Download Rows

Run a warehouse query through a Dekart connection, wait for the job, and save result rows:

dekart query --report-id <report-id> --dataset-id <dataset-id> --connection-id <id> --sql-file ./query.sql --out-dir ./results --wait --json

Queries wait by default; use --no-wait only when you expect an already-finished job. dekart query reuses the given report and dataset: it updates the existing dataset query when one is present, otherwise it creates one query for that dataset. Use --json to return report_id, dataset_id, query_id, job_id, terminal status, report_url, and result_file metadata. Empty downloads fail with empty result (metadata/SHOW statement?).

Preview Downloaded Rows

Preview a CSV or parquet file produced by dekart query:

dekart preview ./results/<result-file>.parquet --limit 20
dekart preview ./results/<result-file>.parquet --schema

Preview output is tab-separated. Parquet and CSV previewing use the bundled DuckDB Python dependency.

Links

• Dekart: dekart.xyz
• geosql skill: github.com/dekart-xyz/geosql