Skip to main content
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 into Cursor, Claude Code, Codex, or another coding agent. Set these environment variables in your agent: 
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 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: 
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. 
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 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.
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.