Setup

Install

pnpm add @retrace-kit/sdk

npm and yarn work too.

Initialize

import { init } from '@retrace-kit/sdk';

init({ apiKey: 'your-project-api-key' });

Get the key from project settings in the app. apiKey is enough for the SDK to send events. Platform details: Browser, Node.js, Python, Java, or Next.js. Optional release from package metadata: SDK → Release.

Same key works for remote MCP in Cursor, Claude Code, Codex, and other agents — see MCP docs and the MCP announce.

Test it

1. Load the page or start the process with a valid key in init.
2. Trigger an error — e.g. throw new Error('test') in the browser console.
3. Check issues in the app.