langwatch

Read LLM traces and coding-agent sessions from LangWatch using the langwatch CLI.

3.5k|362|Updated Sep 9, 2023
One-click install
npx skills add https://github.com/langwatch/langwatch --skill langwatch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: langwatch
Source: https://github.com/langwatch/langwatch/tree/main/plugins/langwatch/skills/langwatch
Command: npx skills add https://github.com/langwatch/langwatch --skill langwatch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When an LLM agent, prompt, or model call misbehaves in production, you need to see what it actually did rather than guess. This Skill lets you query LangWatch traces and coding-agent sessions directly from a coding session using the langwatch CLI, so you can debug failed or slow LLM runs and look up traces by id.

Core Features & Use Cases

  • Trace Search and Retrieval: Search traces from the last 24 hours (or a custom date range) with filters like query text, limit, and origin, then fetch a single trace as JSON.
  • Transcript and Session Inspection: Read a coding-agent trace as an ordered transcript, or list a session's model calls, compactions, rate limits, and tool runs in time order.
  • Use Case: Imagine a checkout agent failed in production overnight. Run langwatch trace search -q "checkout agent" to find the run, then langwatch trace transcript <traceId> to see exactly what the agent did step by step.

Quick Start

Ask the assistant to check that the langwatch CLI is installed and signed in, then search recent LangWatch traces for the agent run you want to inspect.

Frequently Asked Questions about langwatch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search LangWatch traces from the command line?

Run `langwatch trace search -q "your query" --limit 10 -o json` to search traces from the last 24 hours. Widen the window with `--start-date` and `--end-date`, or filter by origin with `--origin application,evaluation,simulation`.

How do I read what a coding agent did in a LangWatch trace?

Use `langwatch trace transcript <traceId>` to get the readable, ordered transcript of what the agent did. Add `-o json` if you want to parse the result programmatically instead of reading it.

How do I check if the langwatch CLI is authenticated?

Run `langwatch whoami` to print the identity persisted by `langwatch login`. If it reports nobody, run `langwatch login` and complete the sign-in flow in the browser; credentials should never be guessed.

Does the LangWatch session hook send my code anywhere?

No. The `langwatch ingest hook` command reports only repository identity such as the repository, branch, and worktree the session is working in. It does not transmit file contents.

Why does a langwatch trace command fail?

Failures differ by cause: a missing trace id, an expired session, or a self-hosted endpoint the CLI was never pointed at each produce distinct errors. Read the CLI's error message to identify the cause instead of retrying the failed read in a loop.