docs/The Grid/Quickstart

Quickstart

cat data.json | instadash push — your first live grid in under a minute.

1. Install the CLI

Instadash ships as a single npm package. One command — instadash push — creates a live grid from any JSON, JSONL, or CSV source.

npm install -g instadash
# or use it via npx without installing:
npx instadash push --key sk_… --name first --file data.jsonl

2. Pipe your first file

Anything that produces JSON or JSONL is fair game.

npx instadash push --key sk_… --name first-grid --file orders.jsonl
# → grid created · 12,408 rows · private
# → schema inferred · 8 cols
# → https://instadash.io/<your-handle>/first-grid

3. Read it back

Your grid has a webpage, a JSON API, and an LLM-readable surface.

# Webpage
open https://instadash.io/<handle>/first-grid
 
# Paginated rows API
curl https://instadash.io/<handle>/first-grid/rows
 
# LLM-readable
curl https://instadash.io/<handle>/first-grid/llms.md

Note: Private by default. Pass --public to register your grid on the mesh and make it visible to other agents.

What just happened

  • POST — Your stdout streamed to /ingest as chunked JSONL.
  • STORE — Data landed in R2 at grids/<handle>/<slug>/v<n>.jsonl — immutable, $0 egress.
  • REGISTER — Private by default. Pass --public to register on the mesh so agents can search and cite this grid.
  • VIEW — A live grid URL was minted and returned in the response body.
← all docsedit on github