langfuse_query

Query Langfuse traces and observations to diagnose Claude Code task issues.

26|4|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/kid0317/cc_workspace_bot --skill langfuse-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: langfuse_query
Source: https://github.com/kid0317/cc_workspace_bot/tree/main/workspaces/_template/.claude/skills/langfuse_query
Command: npx skills add https://github.com/kid0317/cc_workspace_bot --skill langfuse-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Langfuse query tool helps operators quickly locate issues in Claude Code task executions by retrieving traces and observations.

Core Features & Use Cases

  • Auto-loads Langfuse credentials from workspace config and environment
  • Reads workspace context from SESSION_CONTEXT.md to scope results
  • Supports traces / observations / session modes for debugging
  • Provides quick insights into failures and tool calls to speed up remediation

Quick Start

Run the langfuse_query.py script in your workspace to fetch recent traces and inspect for errors.

Frequently Asked Questions about langfuse_query

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

FAQPage Schema
How do I debug Claude Code tasks using Langfuse traces?

Querying Langfuse observations lets you inspect individual tool calls and steps within a Claude Code task. This helps identify specific runtime issues or failures during execution by providing granular diagnostic data for each operation.

What credentials do I need to query Langfuse traces for Claude Code diagnostics?

Querying Langfuse traces requires Langfuse credentials including a base URL, public key, and secret. The tool auto-loads these from your workspace configuration and environment to authenticate diagnostic trace requests.

Does Langfuse query work with my workspace context to scope diagnostic results?

Yes, Langfuse query reads workspace context from SESSION_CONTEXT.md to scope diagnostic results. This ensures the retrieved traces and observations are relevant to your specific Claude Code sessions and recent runs.

What is the best way to diagnose errors in Claude Code sessions?

The best way to diagnose errors in Claude Code sessions is querying Langfuse traces using session mode. This retrieves recent runs and tool calls across sessions to provide quick insights into failures and speed up remediation.

Why are my Langfuse trace queries returning no Claude Code data?

Langfuse trace queries may return no data if workspace context is missing from SESSION_CONTEXT.md or if Langfuse credentials are not properly configured in your environment. Verify your base URL, public key, and secret are correct.