Query and operate Arc,
from the terminal.
Query, write, import, and administer Arc from one command line.
Named connections, script-friendly output, and one static binary.
$ arcli config create --name prod --endpoint https://arc.example.net --token YOUR_TOKEN
$ arcli ping
$ arcli query "SELECT host, avg(usage) AS usage FROM cpu GROUP BY 1 ORDER BY 2 DESC" -o json | jq .dataWhat it is
The operator's client for Arc
arcli turns Arc's HTTP API into clear commands and readable output.
Use it interactively, compose it in a pipeline, or automate it in CI.
Save dev, staging, and production profiles, then switch per command.
Manage tokens, retention, queries, backups, compaction, clusters, and logs.
Structured output, reliable exit codes, and script-friendly confirmation flags.
Capabilities
Arc operations, one command each
From the data path to administration, every workflow follows the same CLI.
Query, four ways out
Run SQL from an argument, file, or stdin. Output tables, JSON, CSV, or Arrow IPC.
Writes in three formats
Stream line protocol or MessagePack, or send JSON validated by the client.
Bulk import
Import CSV, line protocol, Parquet, and TLE files with server-side parsing.
Token lifecycle
Create, rotate, revoke, and delete API tokens, with permissions and expiry.
Retention and continuous queries
Manage data lifecycle and scheduled rollups, with previews and execution history.
Backups and deletes
Create and restore backups, or preview and run predicate deletes.
Cluster, compaction, logs
Inspect cluster health, compaction, schedulers, and recent server logs.
Completion and man pages
Use native completion for bash, zsh, fish, and PowerShell, plus a man page per command.
Sample datasets
Load verified public data into Arc and start exploring it with useful queries.
Quick start
Install, connect, query
Three steps from a package manager to a result table.
Install
brew install basekick-labs/tap/arcliDocker, deb, rpm, Arch, and downloadable archives are also available.
Connect
arcli config create --name local --endpoint http://localhost:8000 --token YOUR-TOKEN
arcli pingSwitch profiles with -c NAME, or use ARC_ENDPOINT and ARC_TOKEN in CI.
Write and query
echo "cpu,host=web-1 usage=0.63 $(date +%s)000000000" | arcli write --database metrics
arcli query --database metrics "SELECT host, avg(usage) FROM cpu GROUP BY 1"
arcli query --database metrics -o csv "SELECT * FROM cpu" > cpu.csvUse -o json, -o csv, or -o arrow for pipelines.
Need the complete command reference? See the arcli documentation.
Arc, one command away
arcli 26.09.4 is available now for Arc 26.06 and newer.