> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usekindred.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get one replayable trace into Kindred.

This guide gets one real agent turn into Kindred, then gets one replay working.

## What you will do

1. Register your agent in Kindred.
2. Connect your agent to Langfuse.
3. Sync the trace into Kindred.
4. Give Kindred a replay URL.
5. Run replay.

## 1. Register your agent

In Kindred, open **Register agent**, give the agent a name, and copy the `KINDRED_AGENT_ID`.

## 2. Add Langfuse to your agent

If you want the fastest setup, paste the prompt in [Use a Coding Agent](/get-started/use-a-coding-agent) into Cursor, Claude Code, Codex, or another coding agent.

Set these environment variables in your agent:

```bash theme={null}
LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_HOST=https://us.cloud.langfuse.com
KINDRED_AGENT_ID=agt_...
```

Each agent turn should include `agent_id`, `session_id`, and `run_id` in Langfuse metadata.

## 3. Send one trace

Run one normal test prompt through your agent. Then open Langfuse and confirm the trace exists.

## 4. Connect Langfuse in Kindred

In Kindred, open **Settings**, then **Langfuse**.

1. Click **Create integration**.
2. Choose the agent or leave it as **Any agent** if traces include `agent_id`.
3. Click **Configure**.
4. Paste the Langfuse public key, secret key, and host.
5. Keep scheduled sync enabled.
6. Click **Save credentials**.
7. Click **Sync now**.

Use the same Langfuse values in your agent `.env` file. See [Environment Variables](/reference/environment-variables) for the exact names to set.

Confirm the trace appears in Kindred.

## 5. Add a replay URL

If your agent is deployed, use its replay endpoint, for example:

```text theme={null}
https://your-agent.example.com/replay
```

If your agent only runs locally, expose it with a tunnel and paste the public tunnel URL into Kindred.

```bash theme={null}
ngrok http 5000
```

Then use the public HTTPS URL as **Target URL (replay\_url)**. You can use any public HTTPS endpoint (deployed service, ngrok, Cloudflare Tunnel, or similar).

Use [Configure Replay URL](/replay/configure-replay-url) if your agent does not have a replay endpoint yet. That page includes a coding-agent prompt that can add one for you.

## 6. Run replay

In Kindred, choose a synced trace or turn, open replay, paste the Target URL, and click **Run**.

Kindred will call your replay URL, find the replay trace in Langfuse, and show the first important difference it finds.

## Quick check

Before a demo, make sure:

* Langfuse has a trace for your test turn.
* The trace includes `agent_id`, `session_id`, and `run_id`.
* Kindred **Sync now** imports the trace.
* The replay URL returns JSON.
* A replay run creates a new Langfuse trace with `kindred_replay_run_id`.

<Tip>
  The usual workflow: run your agent locally, expose it with a public HTTPS tunnel (ngrok, Cloudflare Tunnel, etc.), paste the URL into Kindred, and click **Run**.
</Tip>