quverOS

Docs

Reference

CLI

The quiver command is a thin, scriptable client over the same API — ideal for CI jobs, agents, and quick reads. Every command takes --format json|human.

Setup

Install & authenticate

install

curl -fsSL https://tellquiver.ai/install.sh | sh

Point it at your workspace with a qvr_ key — via env vars or the persisted config (~/.config/quiver/config.json). Env vars win.

auth

# option A — environment
export QUIVER_URL="https://tellquiver.ai"
export QUIVER_API_KEY="qvr_xxxxxxxxxxxx"

# option B — persisted config
quiver config set url https://tellquiver.ai
quiver config set apiKey qvr_xxxxxxxxxxxx

# don't have a key? mint one (printed once)
quiver workspace apikey create "my-agent"

Files

quiver file

quiver file …

Read and mutate files. Mutations go through the real CRDT/KPI path, so dashboards and metrics stay in sync.

Command	Type	Notes
file list	--type --status --search --limit	List files (filterable).
file get <id>		Full file state — fields, status, metadata.
file data <id>		Just the current data-field values.
file set <id> <field> <value>	--type string\|number\|boolean\|json	Set one data field.
file status <id> <status>		Move the file to a status.
file tell <id> <message>		Hand a plain-language update to the file agent.
file run <id> <message>	--context k=v	Same, but streams the agent’s steps live.
file activity <id>	--field --since --limit	Field-change history.
file schema [type]		Show a type’s fields + status workflow (omit to list types).

example

quiver file set $ID value 600 --type number
quiver file status $ID ended
quiver file list --type score --status ended --limit 50 --format human

Metrics & search

quiver metrics · search · tell

quiver metrics …

Read computed values defined in your config.

Command	Type	Notes
metrics list		Available metrics (id, name, type).
metrics get <id>	--period YYYY\|qN-YYYY\|lifetime	One metric’s value + target.
metrics snapshot	--period …	All metrics at once.

example

quiver metrics get leaderboard --format human
quiver search "Alice" --type score
quiver tell "log a new score of 320 for Bob on hard"

Workspace

quiver workspace

quiver workspace …

Workspace info, config, keys, secrets and variables.

Command	Type	Notes
workspace info		Name, id, config, user count.
workspace config [validate]	--file	Print or validate the full config JSON.
workspace apikey list\|create\|delete		Manage qvr_ keys (create prints once).
workspace secret set\|list\|delete		Encrypted, write-only secrets (${secrets.NAME}).
workspace var set\|list\|delete		Plaintext variables (${variables.NAME}).

End to end

A scripted round-trip

bash

export QUIVER_URL="https://tellquiver.ai" QUIVER_API_KEY="qvr_…"

quiver workspace info --format human          # confirm the key resolves
quiver file list --type score --limit 5 --format human
ID=$(quiver file list --type score --limit 1 | jq -r '.[0].id')
quiver file set "$ID" value 999 --type number # writes a KPI
quiver metrics get leaderboard --format human # read the aggregate back