quangdang46

Livekit Agent Simulator — Testing skill for Claude Code

Testing community

Black-box LiveKit voice agent testing: real WebRTC/SIP calls with an AI caller.

How to install Livekit Agent Simulator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open quangdang46/livekit_agent_simulator and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Livekit Agent Simulator does

Black-box LiveKit voice agent testing: real WebRTC/SIP calls with an AI caller. Catch barge-in, noise, quiet-mic, and latency failures that text pytest misses. Forensic reports + MCP + lks CLI — no agent code changes.

Alternatives in Testing

Test Runner — Run Python tests with pytest, unittest, or other testing frameworks 23.4k ★
Test TDD — Run when user calls /test-tdd 957 ★
RocketSimApp — RocketSim — 30+ tools for Xcode's iOS Simulator 791 ★

README

livekit-agent-simulator

![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-blue.svg) ![Python](https://img.shields.io/badge/Python-3.10%E2%80%933.13-blue.svg) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![CI](https://github.com/quangdang46/livekit_agent_simulator/actions/workflows/ci.yml/badge.svg)](https://github.com/quangdang46/livekit_agent_simulator/actions/workflows/ci.yml) [![GitHub release](https://img.shields.io/github/v/release/quangdang46/livekit_agent_simulator)](https://github.com/quangdang46/livekit_agent_simulator/releases)

**Dial any LiveKit voice agent with an AI simulated caller — WebRTC room, inbound SIP, or outbound SIP — and keep a full forensic log.** Standalone MCP server + CLI (`lks`). Black-box testing: no imports from the agent under test, no edits to its code or `.env`.

Quick Install

curl -fsSL "https://raw.githubusercontent.com/quangdang46/livekit_agent_simulator/main/install.sh?$(date +%s)" \
  | bash -s -- --verify

Install via coding agent (copy-paste)

Paste into Claude Code, Cursor, Codex, AmpCode, Windsurf, or any coding agent **from the repo you want to test**:

Install and configure livekit-agent-simulator (CLI: lks) for this project by following the instructions here:
https://raw.githubusercontent.com/quangdang46/livekit_agent_simulator/main/docs/guide/installation.md

Target project root is this workspace. Use absolute --root paths. Install the portable CLI if missing, run lks init, help fill .agent-sim/config.yaml from my local env or ask me for LiveKit + active caller provider key (Gemini Live or OpenAI Realtime) + agent_name, ensure .agent-sim is gitignored,