Arize Agent Kit

Trace AI coding sessions to Arize AX or Phoenix with OpenInference spans. Each harness integration emits spans for prompts, tool calls, model responses, and session lifecycle events.

Supported Harnesses

Harness	Integration	Install Method	Guide
Claude Code CLI	claude-code-tracing	Marketplace or curl	claude-code-tracing/README.md
Claude Agent SDK	claude-code-tracing	Local plugin path	claude-code-tracing/README.md
OpenAI Codex CLI	codex-tracing	install.sh or curl	codex-tracing/README.md

Quick Install

Claude Code (marketplace):

claude plugin marketplace add Arize-ai/arize-agent-kit
claude plugin install claude-code-tracing@arize-agent-kit

Any harness (curl):

curl -fsSL https://raw.githubusercontent.com/Arize-ai/arize-agent-kit/main/install.sh | bash

The installer detects available harnesses and prompts you to choose which integrations to set up.

Configuration

All integrations share the same environment variables. Set them in your harness settings file or export them in your shell.

Environment Variables

Variable	Required	Default	Description
ARIZE_TRACE_ENABLED	No	true	Enable or disable tracing
ARIZE_API_KEY	For AX	-	Arize AX API key
ARIZE_SPACE_ID	For AX	-	Arize AX space ID
ARIZE_OTLP_ENDPOINT	No	otlp.arize.com:443	OTLP gRPC endpoint (on-prem Arize)
PHOENIX_ENDPOINT	For Phoenix	http://localhost:6006	Phoenix collector URL
PHOENIX_API_KEY	No	-	Phoenix API key (if auth enabled)
ARIZE_PROJECT_NAME	No	default	Project name in Arize/Phoenix
ARIZE_USER_ID	No	-	User identifier added to all spans as user.id
ARIZE_DRY_RUN	No	false	Print spans to log instead of sending
ARIZE_VERBOSE	No	false	Enable verbose logging
ARIZE_LOG_FILE	No	/tmp/arize-<harness>.log	Log file path (empty to disable)

Backend Requirements

Backend	Auth	Dependencies	Latency
Phoenix (self-hosted)	PHOENIX_ENDPOINT	jq, curl	~local
Arize AX (cloud)	ARIZE_API_KEY + ARIZE_SPACE_ID	jq, curl, Python, opentelemetry-proto, grpcio	~remote

Phoenix requires no Python — spans are sent via the REST API with bash and jq. Arize AX uses gRPC, which requires Python with opentelemetry-proto and grpcio.

Repository Layout

core/                   Shared span building, state primitives, and gRPC sender
claude-code-tracing/    Claude Code CLI and Agent SDK integration
codex-tracing/          OpenAI Codex CLI integration
install.sh              Curl-pipe installer for non-marketplace harnesses
DEVELOPMENT.md          Guide for adding new harness adapters

Testing

Validate span output without sending data:

ARIZE_DRY_RUN=true <your-harness-command>

Contributing

See DEVELOPMENT.md for how to add a new harness adapter.

Links

• Arize AX
• Phoenix
• OpenInference

License

MIT