Skip to content

impact-ai/impact-sdk-setup

v0.1.0-rc.7Apache-2.0

Connect your app to Impact AI with Codex. Set up supported model and tool tracing, preserve existing telemetry, and verify your first Trace.

Impact SDK Setup

Licensed under the Apache License, Version 2.0 (LICENSE).

Understand your AI. Improve with evidence. Impact SDK Setup helps Codex connect your app to Impact and verify its first useful Trace. Use it with Agent on Azure or another app with a supported JavaScript or Python integration. Keep your native clients and existing telemetry.

Install in Codex

Run these commands at the root of an Agent on Azure checkout that contains the Impact marketplace, or at the root of an unpacked Impact marketplace:

codex plugin marketplace add "$PWD"
codex plugin add impact-sdk-setup@impact-ai

Keep the registered marketplace folder at a stable path. In Codex desktop, you can also select Impact SDK Setup from the registered impact-ai marketplace.

Connect your app to Impact

Open the app you want to instrument in a new Codex session, type $, select impact-sdk-setup:sdk-setup, and ask:

Add Impact tracing to this app. Keep its existing clients and telemetry,
then help me find one real request in Impact.

In Impact AI Control Plane, ask a workspace owner or admin to open Ingest keys → Create ingest key. Set IMPACT_ENDPOINT to the OpenTelemetry exporter settings URL ending in /v1/traces and IMPACT_API_KEY to the raw key in your app's secret configuration. Tell Codex where that configuration lives.

Choose what to capture before sending traffic. Available input, output, tool, retrieval and media content is captured by default within SDK limits and stricter native settings. JavaScript controls · Python controls

Verify one real request

Run your app and find the matching Trace in an authorized Impact session. Your ingest key allows delivery and does not grant read access. Codex reports any capture or verification gaps for your installed integration.

Remove the plugin

codex plugin remove impact-sdk-setup@impact-ai
codex plugin marketplace remove impact-ai

Removing the plugin does not uninstall the SDK or undo application changes.

Offline setup recipes: JavaScript · Python.

The plugin is Apache-2.0 licensed. The Impact AI name and logo are trademarks, not part of that license grant.