Hard time debugging complex AgentSession flows (tools, handoffs, transcripts)

Laksh
Wed, 11 Mar 2026 07:13:04 +0000
Agents

Hi everyone,

While building more complex agents with the LiveKit Agents SDK, I’ve been finding it difficult to understand what’s happening inside an AgentSession while it’s running.

Once agents start doing things like:

multiple tool calls

agent handoffs

streaming transcripts

state transitions (listening → thinking → speaking)

debugging becomes pretty hard. I usually end up relying on console logs or digging through events after the run, which gets messy quickly.

LiveKit’s Agent Observability is great for post-run insights and metrics, but during development I often wish there was something like a live debugger for the agent session.

So I built Liveflow.

It’s a VS Code extension + Python package that visualizes your LiveKit agent in real time when it runs.

No code changes required.

It intercepts AgentSession events and shows things like:

agent handoffs

tool execution timeline

live transcripts

LLM context

agent state

What it shows

Agent graph - visualize agents, handoffs, and tool calls

Tool timeline - every function tool execution

Live transcripts - speech → text streaming

Chat context inspector - full LLM context window

Agent state - listening / thinking / speaking

To get started:
https://liveflow.lakshyaworks.dev/

Or directly install the Liveflow extension in your preferred IDE.

3 posts - 3 participants