lobsterone
v0.5.0
Published
Connect AI coding agent telemetry to LobsterOne in one command
Maintainers
Readme
lobsterone
Connect Claude Code and Codex telemetry to LobsterOne in one command.
Quick start
npx lobsterone setupThis will walk you through sign-in (or account creation), generate API keys, and configure Claude Code and/or Codex automatically.
Commands
setup
Zero-to-done onboarding. Creates an account if needed, generates API keys, and writes telemetry config to Claude Code and/or Codex settings.
npx lobsterone setup
npx lobsterone setup --source codex
npx lobsterone setup --source all --no-verifyconnect
Already have an API key from the dashboard? Connect it directly.
npx lobsterone connect --key rc_YOUR_KEY
npx lobsterone connect --key rc_YOUR_KEY --source codex
npx lobsterone connect --key rc_YOUR_KEY --source codex --no-verifyjoin
Join your team's organization using a setup token from an admin.
npx lobsterone join --token rst_YOUR_TOKEN
npx lobsterone join --token rst_YOUR_TOKEN --source all
npx lobsterone join --token rst_YOUR_TOKEN --source all --no-verifystatus
Check whether LobsterOne is configured and the connection is healthy.
npx lobsterone status
npx lobsterone status --json
npx lobsterone status --json --fail-on-issuesdisconnect
Remove LobsterOne telemetry config from Claude Code and/or Codex. Your API key is preserved in the dashboard and can be revoked there.
npx lobsterone disconnect
npx lobsterone disconnect --source codexrename
Rename a configured Claude Code or Codex instance.
npx lobsterone rename "Mac Mini Bot" --source codeximport
Import historic Claude Code usage from Claude's local stats-cache.json. This command is Claude Code only.
npx lobsterone import --dry-runHow it works
Claude Code and Codex have built-in OpenTelemetry support. The CLI writes LobsterOne telemetry settings into Claude Code (~/.claude/settings.json) and Codex (~/.codex/config.toml) while preserving unrelated telemetry config already present on the machine. No agents, no SDKs, no background processes.
Requirements
- Node.js 18+
- Claude Code and/or Codex installed
Development
npm install
npm run build # compile TypeScript
npm run dev # run from source via tsx
npm test # build and run regression testsLicense
MIT
