Langfuse Traces Skill
Query and analyze Langfuse trace data directly from Claude Code.
Usage
Invoke the query script using the base directory shown above:
bash <base_directory>/scripts/query.sh <command> [options]Commands
| Command | Args | Description |
|---|---|---|
traces | [limit] [session_id] [name] | List recent traces |
trace | trace_id | Get full trace with observations |
observations | [limit] [trace_id] | List spans/generations |
sessions | [limit] | List sessions |
summary | [limit] | Compact one-line-per-trace view |
Examples
# List last 20 traces
bash <base_directory>/scripts/query.sh traces 20
# Get specific trace detail
bash <base_directory>/scripts/query.sh trace tr-abc123
# List observations for a trace
bash <base_directory>/scripts/query.sh observations 50 tr-abc123
# Quick summary of recent activity
bash <base_directory>/scripts/query.sh summary 10Credentials
The script reads credentials from .env.local, .env, or environment variables:
LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_BASE_URL=https://cloud.langfuse.com # optional, defaultRequirements
curl(standard on macOS/Linux)jqfor JSON parsing
Output
All commands return JSON (piped through jq). Use jq filters for specific fields:
bash <base_directory>/scripts/query.sh traces 5 | jq '.data[].name'