Documentation

Optelly gives you real-time observability for AI coding agents. Connect your CLI tools via OpenTelemetry in one command — no proxy, no SDK, no code changes.

Supported Tools

Optelly works with any AI coding tool that exports OpenTelemetry. The tools above have been tested and are fully supported.

Quick Start

Get set up in 30 seconds:

# Install and configure (auto-detects your tools)
npx optelly setup

# Start a coding session as usual
claude  # or codex, gemini

# Open optelly.com — your agent appears in the office

The setup command authenticates you via GitHub, detects installed AI tools, and configures their OTel exporters to send telemetry to Optelly.

Setup Options

# Configure a specific tool
npx optelly setup --tool claude

# Use an existing API key (skip GitHub auth)
npx optelly setup --key ok_abc123def456

# Non-interactive: configure all detected tools
npx optelly setup -y

# Verify your configuration
npx optelly setup --check

How It Works

Optelly uses OpenTelemetry — the open standard for observability. When you run npx optelly setup, it sets environment variables that tell your AI coding tool to export telemetry data (traces, metrics, logs) to Optelly's collector.

No proxy sits between you and your AI tool. No SDK is injected. Optelly reads the same telemetry your tool already produces — it just gives you a way to see it.

What Gets Collected

• Sessions — start time, end time, duration, agent source
• Token usage — input tokens, output tokens, cache read/write
• Cost estimates — based on model and token counts
• Tool calls — which tools the agent used (file edits, shell commands, etc.)
• Model info — which model was used per request

Optelly does not collect your code, prompts, or AI responses. Only operational metadata is captured.

OTel Environment Variables

For reference, npx optelly setup configures the following environment variables:

Variable	Value
OTEL_METRICS_EXPORTER	otlp
OTEL_LOGS_EXPORTER	otlp
OTEL_EXPORTER_OTLP_PROTOCOL	http/json
OTEL_EXPORTER_OTLP_ENDPOINT	https://optelly.com
OTEL_EXPORTER_OTLP_HEADERS	x-optelly-key=<your_key>

You can also set these manually if you prefer not to use the CLI.

CLI Commands

Command	Description
npx optelly setup	Authenticate and configure AI tools for OTel export
npx optelly setup --check	Verify OTel configuration and test server connectivity
npx optelly login	Authenticate via GitHub (without configuring tools)
npx optelly status	Show current configuration and connection status

Pricing

Feature	Free	Pro ($10/seat/mo)
Live 3D office	Unlimited agents	Unlimited agents
Data retention	24 hours	90 days
Analytics	Last 24h	Full history + trends
Export (CSV/JSON)	—	Included
Team analytics	—	Per-user breakdown