@thingd/cli

CLI, interactive TUI dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.

Install

npm install -g @thingd/cli

Usage

# Start the MCP server (for AI agents — Cursor, Claude Desktop)
thingd mcp

# Start the HTTP MCP server + dashboard
thingd mcp-http

# Optional encrypted native storage; inject the key, do not put it in MCP config
THINGD_ENCRYPTION_KEY=<64-hex-characters> thingd mcp --driver native

# Offline migration or key rotation
THINGD_ENCRYPTION_SOURCE_KEY=<old-key> \
THINGD_ENCRYPTION_DESTINATION_KEY=<new-key> \
thingd db reencrypt --source ./old-db --destination ./new-db

# Open the TUI dashboard
thingd dashboard

# Manage objects
thingd objects list <collection>
thingd objects get <collection> <id>
thingd objects put <collection> <id> --data '{"text":"hello"}'
thingd objects delete <collection> <id>
thingd objects put-batch <collection> --file <path>
thingd objects delete-batch <collection> <id1> [id2] ...

# Events
thingd events append <stream> <type> --text "event data"
thingd events list [stream]

# Queues
thingd queues push <queue> --payload '{"key":"value"}'
thingd queues claim <queue>
thingd queues ack <queue> <jobId>
thingd queues nack <queue> <jobId>

# Links
thingd links create <fromRef> <linkType> <toRef>
thingd links neighbors <reference>

# Utilities
thingd search <query>
thingd status
thingd doctor
thingd install
thingd export --collection <name> --out <path>
thingd import --collection <name> --in <path>
thingd snapshot create --out <path>
thingd snapshot restore --in <path>

# Cloud app setup for mobile/web projects
thingd cloud login
thingd cloud project create nice-rep
thingd cloud instance create nice-rep nice-rep
thingd cloud instance use nice-rep nice-rep
thingd cloud app init --file nice-rep.app.json --name "Nice Rep" --slug nice-rep
thingd schema check schema.thingd
thingd cloud app bootstrap --project nice-rep --instance nice-rep --file nice-rep.app.json --schema schema.thingd --dry-run
thingd cloud app config --project nice-rep --instance nice-rep
thingd cloud app version create --project nice-rep --instance nice-rep --app nice-rep

For mobile and web apps, use createThingdAppClient from @thingd/client. The Cloud CLI token is an operator credential and must never be bundled in an Expo application. thingd cloud app config returns the publishable key that is safe to configure in a mobile app; app-user access tokens are issued by the app backend after signup or login.

The app definition is a versioned thingd.app/v1 JSON document. Its actions field is the sole action source; the SDK's deprecated functions alias uses the same published routes for compatibility. The CLI checks the JSON shape and delegates full policy validation to Cloud. schema.thingd is the runtime schema and is validated locally before a non-dry-run bootstrap.

Full reference: CLI Reference · Nice Rep mobile setup