Skip to main content
@carbon-js/connect (the @carbon-js/connect package) wires your AI coding apps’ built-in OpenTelemetry exporters to Carbon. It runs from npx — no install — and edits each app’s own config, so there’s no daemon and no changes to your projects.

​
Interactive setup

With no arguments it walks you through setup: it detects the apps installed on your machine, lets you pick which to connect, and prompts for your API key. 
npx @carbon-js/connect@latest
Restart each app afterward so it reloads its config and starts exporting.
When only one supported app is detected, the picker is skipped and that app is connected directly.

​
Commands

@carbon-js/connect                          interactive setup (detect → pick → connect)
@carbon-js/connect connect [codex|claude-code]
                                        connect an app (interactive when no app is given)
@carbon-js/connect status                   show which apps are connected, as a table
@carbon-js/connect disconnect [codex|claude-code]
                                        disconnect an app (interactive when none is given)

​
connect

Connect a single app directly by naming it, passing the key inline: 
npx @carbon-js/connect@latest connect codex --key crb_…
Each app’s key is written into its own config, so you can point different apps at different Carbon spaces. Key resolution and per-app keys are covered in API keys; the exact config edit in How it works.

​
status

Print a table of every supported app and whether it’s connected. Pass an app name to narrow it to one: 
@carbon-js/connect status            # all apps
@carbon-js/connect status codex      # just Codex

​
disconnect

Cleanly revert the connection — removing exactly the keys it added and leaving the rest of the config untouched: 
@carbon-js/connect disconnect claude-code

​
Requirements

  • Node ≥ 18
  • Claude Code and/or Codex installed locally
Restart an app after connecting or disconnecting for the change to take effect.