@ciandt-flow/flow-ai-obs weekly downloads statistics

flow-ai-obs

Automatic observability for Claude Code sessions — powered by Flow by CI&T.

flow-ai-obs captures every Claude Code session as a structured trace in Langfuse with zero configuration changes to your workflow.

• Root span per prompt — input, output, token usage, estimated cost
• Child span per tool call — timing, arguments, output, error detection
• Skill context — detects /skill-name invocations and enriches traces with skill metadata
• Offline buffer — traces are persisted locally and replayed automatically when the gateway is back online

---

Requirements

• Node.js >= 18.0.0
• Claude Code with hooks enabled
• A valid Flow by CI&T account

---

Quick Start

# 1. Install globally
npm install -g @ciandt-flow/flow-ai-obs

# 2. Run init — guides you through authentication and hook registration
flow-ai-obs init

# 3. Verify
flow-ai-obs status

That's it. Every Claude Code session with Skills or Agents now generates traces automatically.

---

CLI Commands

Command	Description
flow-ai-obs init	Configure environment: authenticate + register hooks in Claude Code
flow-ai-obs login	Re-authenticate (refresh credentials)
flow-ai-obs status	Show current auth status and hook configuration
flow-ai-obs update	Update to the latest version

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.