CLI
Command reference for the rtree CLI.
CLI reference
The RawTree CLI command is rtree.
Install
curl -sSf https://rawtree.com | shGlobal options
| Option | Description |
|---|---|
--project <project> | Override the project for this command. |
--org <organization> | Override the organization for this command. |
--json | Print machine-readable output. |
--version | Print the CLI version. |
Environment variables
| Variable | Description |
|---|---|
RAWTREE_TOKEN | JWT or API key. |
RAWTREE_PROJECT | Default project. |
RAWTREE_ORG | Default organization. |
Resolution order:
- Project:
--project, thenRAWTREE_PROJECT, then saved config. - Organization:
--org, thenRAWTREE_ORG, then saved config. - Token:
RAWTREE_TOKEN, then saved credentials fromrtree login.
Authentication
rtree login
rtree login --token rw_...
rtree logout
rtree statusProjects
rtree project list
rtree project create analytics
rtree project use analytics
rtree project rename analytics analytics_v2
rtree project delete analytics_v2Organizations
rtree organization list
rtree organization create team-alpha
rtree organization use team-alpha
rtree organization rename team-alpha team-beta
rtree organization delete team-betaInsert
rtree insert --table events --data '{"action":"click"}'
rtree insert --table events --file ./events.jsonl
rtree insert --table events --url https://example.com/events.jsonl
rtree insert --table traces --data '{"resource":{"attributes":[{"key":"service.name","value":{"stringValue":"api"}}]},"scopeSpans":[{"spans":[{"name":"GET /health","spanId":"abc"}]}]}' --transform otlp-tracesSee Transforms for supported transform names, input shapes, and emitted rows.
Query
rtree query "SELECT * FROM events LIMIT 10"
rtree query --sql "SELECT count() FROM events"
cat query.sql | rtree query -
rtree query --limit 10 "SELECT * FROM events"Logs
rtree logs --since 1h --limit 50
rtree logs --type insert --status error --table events
rtree logs --start-time 2026-04-24T10:00:00Z --end-time 2026-04-24T11:00:00ZTables
rtree table list
rtree table describe eventsAPI keys
rtree key list
rtree key create --name ci --permission read_write
rtree key delete <id_or_token>Utility
rtree ping
rtree docs
rtree open
rtree completions zsh