instadash

Pipe anything → live grid. Optional publish to a public mesh agents can search.

npm i -g instadash
echo '{"hello":"world"}' | instadash push --name first
# https://instadash.io/g/<your-handle>/first

→ instadash.io

Auth

instadash login          # device flow — opens browser, stores key locally
instadash logout         # remove stored key
export INSTADASH_KEY=sk_…  # or pass --key on every command

Keys are sent as Authorization: Bearer sk_….

Sign in at instadash.io/get-started to mint a key.

Commands

push — named, versioned grid

The grid lives at instadash.io/g/<your-handle>/<slug> (public) or /p/... (private). Re-pushing the same name creates a new version; existing readers see the latest.

# from a file
instadash push --name sales --file data.jsonl

# from stdin (auto-detected — no --file needed)
echo '{"region":"AU","revenue":1200}' | instadash push --name sales

# private + tagged
instadash push --name sales --file data.jsonl --private --tags finance,au

| Flag | Description | |------|-------------| | --file / -f | Path to a file (JSON object, JSON array, or JSONL). Omit to read from stdin. | | --name / -n | Grid slug. Defaults to filename without extension, or stdin. | | --private | Owner-only access; not indexed in the public mesh. Requires Builder plan. | | --title | Display title shown on the mesh | | --description | Used in mesh search and llms.txt | | --tags | Comma-separated tags for mesh discovery | | --key / -k | API key (or set INSTADASH_KEY) | | --url / -u | Override worker base URL (must be HTTPS) |

grids — list your grids

instadash grids

  results-sample    public     3 rows  v1  https://instadash.io/g/…/results-sample
  sunshine-parts    public   60644 rows  v1  https://instadash.io/g/…/sunshine-parts
  private-data      private      8 rows  v2  https://instadash.io/p/…/private-data

visibility — change a grid's visibility

No re-upload required. The grid data stays in place.

instadash visibility sales private   # make private (Builder plan required)
instadash visibility sales public    # make public again

versions — show version history

instadash versions sales

v   timestamp                 rows  source  sha256
─   ─────────────────────     ────  ──────  ────────
v3  2026-05-04T10:33:12.000Z  4128  api     a3c91f08
v2  2026-05-04T10:21:55.000Z  4012  api     74e6b201
v1  2026-05-04T10:18:09.000Z  4000  api     1820af9e

whoami — show current identity

instadash whoami
# vccIbxr1krh1Z7Op  · plan: builder  · grids: 5

instagrid push

Same binary, different name. instagrid push ... is identical to instadash push ....

What's a JSONL file?

One JSON object per line:

{"name":"Alice","revenue":1200,"region":"US"}
{"name":"Bob","revenue":950,"region":"EU"}
{"name":"Carol","revenue":1450,"region":"US"}

push accepts JSONL, a JSON array ([{…}, {…}]), or a single JSON object.

Output

All commands write the final URL to stdout; progress logs go to stderr.

URL=$(echo '{"x":1}' | instadash push --name foo)
open "$URL"

Set NO_COLOR=1 to disable ANSI styling. Pipes auto-disable colour.

Plans

| | Free | Builder | Agent | |--|------|---------|-------| | Rows per push | 1 000 | 100 000 | 5 000 000 | | Grids | 3 | Unlimited | Unlimited | | Private grids | — | ✓ | ✓ | | /rows API | — | ✓ | ✓ |

Upgrade at instadash.io/pricing. The CLI shows an upgrade link on any plan-limit error.

License

MIT