langfuselisted

# Langfuse This skill helps you use Langfuse effectively: debugging traces, inspecting LLM generations and tool calls, reviewing sessions, and managing prompts. ## Core Principles 1. **Use the query script for data access**: Run `langfuse_query.sh` for all Langfuse queries. It detects the server's API generation and picks the right endpoints. The script ships in this skill's `bin/` directory, which is on the Bash tool's `PATH` whenever the skill is installed — invoke it by bare name, never by an absolute path. 2. **Documentation First**: When implementing SDK integrations, always fetch current docs before writing code (Langfuse updates frequently). ## Per-Project Configuration (.agent.env) Each project should have a `.agent.env` file in the project root: ``` LANGFUSE_BASE_URL: http://localhost:3000 LANGFUSE_PUBLIC_KEY: pk-lf-... LANGFUSE_SECRET_KEY: sk-lf-... ``` - `LANGFUSE_BASE_URL`: base URL of your Langfuse instance — local, EU cloud (`https://cloud.langfuse.com`), or US cloud (`https://us.cloud.langfuse.com`). - API keys are in your Langfuse project under **Settings > API Keys**. If any value is missing from `.agent.env`, ask the user to add it before proceeding. ## Permissions The query script is meant to be pre-approved, via this rule: ``` Bash(langfuse_query.sh:*) ``` **Neither install route installs that rule** — it ships in the toolkit's `project-files/.claude/settings.json` template, which the user merges into a project's `.claude/settings.json` (or t