Skip to content
vario

Observe
everything AI.

Vario is an open-source command-line tool that collects your AI conversations, token usage and execution telemetry into a ClickHouse database you control.

curl -fsSL https://raw.githubusercontent.com/nedanwr/vario/master/scripts/install.sh | sh

Installs to ~/.local/bin. Verifies the checksum and needs no admin rights. Read the script

What Vario does

Capture

Conversations, tokens and execution telemetry.

Reads AI tools' local data, read-only, starting with T3 Code: token usage for every turn, commands, tool calls and file changes. Message content is collected only if you opt in.

Store

Your data, your ClickHouse instance.

Delivered over HTTP(S) to a database you run. A local spool holds data through network outages, ClickHouse downtime and reboots.

Observe

Query and analyze your AI usage.

Ready-made views for daily token usage and tool usage. Ask anything else in plain SQL.

Get started

vario init  vario run   

init walks you through the setup: connecting to ClickHouse, creating the database, choosing what to collect and selecting your sources. run then collects continuously. Background services, migrations and queries are covered in the documentation.