Telemio CLI

Telemio is an OpenTelemetry-native observability platform for applications, infrastructure, browser and mobile experiences, and AI agents.

This npm package is intentionally limited to the public setup CLI. The Telemio service runtime, internal APIs, deployment configuration, infrastructure details, private operational tooling, and application source are not distributed in the npm artifact.

Install

Canonical package:

npm install --global @wundercorp/telemio

Compatibility package:

npm install --global telemio

Both packages expose the same executable:

telemio --help

Detect and configure a repository

telemio detect
telemio setup auto

The CLI can print setup guidance for Node.js, Python, Java/JVM, .NET, PHP, Ruby, Go, Rust, Swift/iOS, Android/Kotlin, Collector, Kubernetes, Lambda, edge runtimes, messaging, agentic runtimes, desktop applications, GPU/inference systems, and profiles.

OpenTelemetry setup

telemio setup otel --service checkout-api
telemio setup collector
telemio setup kubernetes

Use --endpoint when the OTLP endpoint differs from the hosted or local environment you are configuring.

Browser and distributed clients

telemio setup rum --app storefront

Browser, mobile, React Native, and desktop clients should use client-safe ingest credentials or a trusted Collector/gateway. Never embed a privileged server API key in distributed software.

Prometheus setup

telemio setup prometheus

StatsD setup

telemio setup statsd

JavaScript/TypeScript SDK

For explicit business, agent, feature-flag, experiment, or application context in trusted JavaScript/TypeScript runtimes:

npm install @telemio/sdk

OpenTelemetry remains the default instrumentation layer; the SDK adds Telemio-specific context where it helps.

Coding agents and agent runtimes

Auto-detect supported local harnesses:

telemio detect agents
telemio setup agent auto

Generate runtime-specific telemetry setup for Claude Code, OpenAI Codex, Hermes Agent, Loki Agent, Gemini CLI, GitHub Copilot CLI, Cursor, OpenCode, or Windsurf:

telemio setup agent claude-code
telemio setup agent codex
telemio setup agent hermes
telemio setup agent loki
telemio setup agent gemini
telemio setup agent copilot

Native OTLP exporters are preferred when the harness provides them. Hook adapters are used as an enrichment/fallback path, and prompt/response/tool content remains disabled by default.

For a repository-wide coding-agent setup prompt:

telemio agent-prompt

The generated prompt asks a coding agent to detect runtime boundaries, prefer standard OpenTelemetry instrumentation, correlate signals, add browser/mobile/agent telemetry where appropriate, keep AI capture metadata-first, redact sensitive data, and verify the resulting changes.

Runtime sessions

Create bounded runtime sessions for services, workers, agents, VMs, jobs, browser automation, mobile/desktop applications, serverless execution, and workflows:

telemio runtime start --kind worker --provider my-platform --external-id "$JOB_ID"
telemio runtime list
telemio runtime link rt_...
telemio runtime end rt_...

runtime start returns a short-lived ingest token and a direct console.telemio.sh/runtimes/... link. Use --json when another application needs to consume the runtime ID, token, or console URL programmatically. Distributed browser/mobile/desktop applications should bootstrap runtime sessions with client-safe ingest keys rather than privileged server credentials.

Runtime requirements

Node.js 20.19 or newer.

Package boundary

The published npm package contains a minified dist/telemio.mjs executable, this README, the license, and package metadata. Source modules, backend/server code, internal API documentation, deployment scripts, infrastructure configuration, tests, and repository documentation are excluded from the public npm package.