flow-ai-obs
Automatic observability for Claude Code sessions — powered by Flow by CI&T.
flow-ai-obs configures Claude Code's native OpenTelemetry integration to report metrics and logs to Flow, authenticated with a single FLOW_API_KEY — no proxy, no separate login step.
- Native OTEL metrics and logs — Claude Code reports directly, no hooks or subprocesses involved
- Zero-friction auth — one environment variable (
FLOW_API_KEY), no interactive login - Direct mode (opt-in) — send traces straight to your own Langfuse instance via
FLOW_TELEMETRY=true(seedocs/work-modes/)
Requirements
- Node.js >= 18.0.0
- Claude Code
- A
FLOW_API_KEYfor your Flow by CI&T tenant, set in your environment
Quick Start
# 1. Set your Flow API key (see your Flow tenant's setup guide for where to get it)
export FLOW_API_KEY="<YOUR_FLOW_API_KEY>"
# 2. Install globally
npm install -g @ciandt-flow/flow-ai-obs
# 3. Run init — configures native OTEL telemetry for Claude Code
flow-ai-obs init
# 4. Verify
flow-ai-obs status
That's it. Claude Code now reports metrics and logs automatically via native OpenTelemetry.
CLI Commands
| Command | Description |
|---|---|
flow-ai-obs init | Configure environment: native OTEL telemetry for Claude Code |
flow-ai-obs status | Show current authentication and observability configuration |
flow-ai-obs update | Update to the latest version |
FLOW_API_KEYis the only supported authentication method — there is nologincommand.
init flags
flow-ai-obs init --custom-url https://your-tenant.ciandt.com # custom domain
flow-ai-obs init --no-interactive # CI/CD mode
License
This package is proprietary software by CI&T Inc., made available on the npm public registry for use within authorized CI&T products and services.