Back to Langfuse

Langfuse Repository And Skill Map

.agents/skills/langfuse-codebase-navigator/references/repository-map.md

3.192.214.0 KB
Original Source

Langfuse Repository And Skill Map

Snapshot source: gh repo list langfuse --limit 1000 --json name,description,isPrivate,isArchived,isFork,primaryLanguage,pushedAt,updatedAt,url on 2026-05-11. All repos below were unarchived and not forks at the time of capture. Refresh the inventory when the user asks for "latest" repo state.

Core Routes

NeedStart HereThen Check
Product UI, API routes, tRPC, auth, billing, prompts, datasets, evals, traces, sessions, scores, modelslangfuse/langfuseweb/src/features/**, web/src/pages/**, web/src/app/**, packages/shared/src/**
Ingestion, queues, async jobs, exports, retention, evaluation runners, background workerslangfuse/langfuseworker/src/**, packages/shared/src/server/**
Shared domain types, repositories, services, Postgres/ClickHouse querieslangfuse/langfusepackages/shared/src/domain/**, packages/shared/src/server/**, packages/shared/src/server/queries/**
Public API schema and generated server/client definitionslangfuse/langfusefern/apis/server/definition/**, fern/apis/client/definition/**, generated clients
Docs, changelog, blog, handbook, cookbook, integrations, website componentslangfuse/langfuse-docscontent/**, app/**, components/**, components-mdx/**, cookbook/**
JS/TS SDKs and integrationslangfuse/langfuse-jspackages/client, packages/core, packages/tracing, packages/otel, packages/openai, packages/langchain
Python SDKlangfuse/langfuse-pythonlangfuse/**, langfuse/api/**, tests/**
Java SDKlangfuse/langfuse-javaGenerated Java client and tests
Cloud infrastructure, Terraform, ClickHouse operations, load tests, infra scriptslangfuse/infrastructureterraform/**, clickhouse/**, scripts/**, load-tests/**
Kubernetes / Helm deploymentlangfuse/langfuse-k8sHelm chart and Kubernetes templates
Terraform deployment moduleslangfuse/langfuse-terraform-aws, langfuse/langfuse-terraform-gcp, langfuse/langfuse-terraform-azureProvider-specific module files
Terraform providerlangfuse/terraform-provider-langfuseProvider resources, generated schema, tests
Public agent skill for using Langfuselangfuse/skillsskills/langfuse/SKILL.md and its references
Internal Langfuse team skillslangfuse/langfuse-internal-skillsTop-level skill folders in this repo
CLIlangfuse/langfuse-clisrc/**, bin/**, openapi.yml
MCP prompt-management serverlangfuse/mcp-server-langfusesrc/**
n8n nodelangfuse/n8n-nodes-langfuseNode package source
GitHub Action for experimentslangfuse/experiment-actionaction.yml, src/**, schemas/**
Exampleslangfuse/langfuse-examplesExample app directories
API reference sitelangfuse/langfuse-api-referenceStatic/generated API reference assets

Repositories

RepoVisibilityLanguageRoute When
.githubPublicn/aOrganization profile, default community health, org-wide GitHub metadata.
202604-offsite-slidesPrivateTypeScriptInternal offsite slide deck work. Only route here when the user names it or asks for those slides.
analyticsPrivateShellAnalytic data pipeline and documentation, cost/data marts, analytics scripts.
background-jobsPrivateTypeScriptSparse metadata, older private background-job work. Inspect README before using.
experiment-actionPublicTypeScriptGitHub Action workflow support for running Langfuse experiments.
infrastructurePrivateHCLLangfuse Cloud infrastructure, Terraform, ClickHouse ops, infra scripts, load tests.
langfusePublicTypeScriptMain product monorepo: web app, API, worker, shared packages, generated API definitions.
langfuse-api-referencePublicHTMLGenerated or static API reference site.
langfuse-cliPublicTypeScriptCLI wrapper around Langfuse API.
langfuse-docsPublicMDXDocs, changelog, blog, integrations, cookbook, handbook, marketing/docs website.
langfuse-examplesPublicTypeScriptExample apps showing deployment and Langfuse usage.
langfuse-ghsa-gccw-7cqr-2cjmPrivateTypeScriptSecurity advisory remediation/reproduction work for that GHSA. Treat as sensitive.
langfuse-internal-skillsPrivatePythonInternal team skills for support, PR funnel, social copy, meeting notes, Plain search, writing, and routing.
langfuse-javaPublicJavaAuto-generated Java client for the Langfuse API.
langfuse-jsPublicTypeScriptJS/TS SDK packages and integrations for tracing, OpenAI, LangChain, OTel, prompts, datasets, scores.
langfuse-k8sPublicGo TemplateCommunity-maintained Kubernetes config and Helm chart.
langfuse-opsPrivateJavaScriptPrivate ops utilities. Inspect README/scripts before using.
langfuse-playgroundPrivatePythonPrivate playground/prototype code. Use when named or search evidence points here.
langfuse-pythonPublicPythonPython SDK, generated API client, decorators, OTel, LangChain/OpenAI integration tests.
langfuse-terraform-awsPublicHCLTerraform module for AWS deployment.
langfuse-terraform-azurePublicHCLTerraform module for Azure deployment.
langfuse-terraform-gcpPublicHCLTerraform module for GCP deployment.
mcp-server-langfusePublicTypeScriptMCP server for Langfuse prompt management.
n8n-nodes-langfusePublicJavaScriptn8n node for Langfuse prompt management.
nofilterPrivateTypeScriptHackathon/prototype repo. Use only when named or search evidence points here.
oss-llmops-stackPublicn/aModular OSS LLMOps stack combining LiteLLM and Langfuse.
platformPrivatePythonSparse metadata, private platform repo. Inspect README before routing non-obvious work here.
skillsPublicPythonPublic installable Langfuse agent skill for using Langfuse and its docs/API.
task-search-barPrivateTypeScriptSmall private task/prototype repo. Use when named.
terraform-provider-langfusePublicGoTerraform provider for managing Langfuse resources.
tmp-langfuse-otel-jsPrivateTypeScriptTemporary repo for new JS SDK v4 / OTel work. Check whether work has moved to langfuse-js.

Main Product Monorepo

Start at the sibling checkout langfuse in the same parent directory as the current Langfuse repo.

Important areas:

  • web/src/features/**: feature-oriented UI, hooks, server modules, pages, and components.
  • web/src/pages/**: Next.js pages and API routes.
  • web/src/app/**: App-router routes and app-level APIs.
  • web/src/components/**: shared UI, trace display, tables, layouts, design-system components.
  • packages/shared/src/domain/**: shared domain interfaces and business types.
  • packages/shared/src/server/**: repositories, services, auth, cache, ClickHouse/Postgres queries, S3, Redis, pricing, LLM helpers.
  • packages/shared/src/server/queries/**: ClickHouse and Postgres SQL query builders.
  • packages/shared/src/features/**: shared feature logic for prompts, datasets, scores, evals, model pricing, folders, comments, entitlements.
  • worker/src/features/**: async feature processors for evaluations, experiments, batch actions/exports, notifications, traces, tokenization, cleanup.
  • worker/src/services/**: ingestion service, ClickHouse writer, DLQ, and worker service primitives.
  • worker/src/queues/**: queue definitions and processors.
  • fern/apis/server/definition/**: server/public API definitions.
  • fern/apis/client/definition/**: generated client API definitions.
  • ee/src/** and web/src/ee/**: enterprise-specific code.

Repo-local skills in langfuse/.agents/skills:

  • agent-setup-maintenance: agent config, generated shims, shared skill routing.
  • add-model-price: model price defaults, provider price keys, tokenizer IDs, match patterns.
  • analyze-cloud-costs: Langfuse Cloud cost analysis.
  • backend-dev-guidelines: tRPC, API endpoints, worker processors, Prisma, ClickHouse services, backend tests.
  • changelog-writing: user-facing release notes.
  • clickhouse-best-practices: ClickHouse schema/query/migration review.
  • code-review: repo-specific correctness/regression review.
  • datadog-query-recipes: reusable Datadog query shapes for production research.
  • debug-issue-with-datadog: production debugging tied to Langfuse code paths.
  • frontend-browser-review: user-visible web/** changes and browser verification.
  • frontend-large-feature-architecture: large frontend features, controller state, and rendering performance.
  • git-workflow: Langfuse repo Git, GitHub, branch, commit, PR, and issue workflow.
  • housekeeping: recurring work queue review across Linear, Pylon, and GitHub.
  • langfuse-codebase-navigator: org, repository, folder, and skill routing.
  • linear-bug-triage: Linear issue deduplication and bug evidence workflows.
  • pnpm-upgrade-package: dependency upgrades under pnpm release-age constraints.
  • security-review: security review patterns for user-supplied URLs, secrets, tenancy, and auth scopes.
  • seed-test-data: local Langfuse seed scenarios for traces, sessions, lists, and event data.
  • skill-creator: create or update repo-owned skills.
  • storybook: write or review React component stories.
  • turborepo: task graph, caching, package-boundary work.
  • weekly-production-review: weekly production review across Datadog, incident.io, Linear, and fixes.

Additional web skills in langfuse/web/.agents/skills:

  • vercel-react-best-practices
  • vercel-composition-patterns

Docs Repo

Start at the sibling checkout langfuse-docs in the same parent directory as the current Langfuse repo.

  • content/docs/**: product documentation.
  • content/changelog/**: changelog entries.
  • content/blog/**: blog posts.
  • content/integrations/**: integration docs.
  • content/self-hosting/**: self-hosting docs.
  • cookbook/**: runnable examples and notebooks.
  • app/**: Next.js routes for docs, blog, changelog, guides, integrations, library.
  • components/** and components-mdx/**: docs site UI and MDX components.

Repo-local skill found in this checkout:

  • .claude/skills/add-yourself-to-team-langfuse/SKILL.md.

SDKs And Integrations

langfuse-js:

  • packages/client: high-level client, prompts, datasets, scores, experiments.
  • packages/core: shared API client, constants, media, propagation, utilities.
  • packages/tracing: tracing wrappers and provider.
  • packages/otel: OpenTelemetry span processor and media service.
  • packages/openai: OpenAI integration helpers.
  • packages/langchain: LangChain callback handler.
  • tests/e2e and tests/integration: behavior coverage.

langfuse-python:

  • langfuse/_client: core client, observe decorator, spans, datasets, propagation.
  • langfuse/api: generated API clients.
  • langfuse/langchain, langfuse/openai.py: integrations.
  • langfuse/_task_manager: ingestion and media upload queues.
  • tests/**: SDK behavior and integration tests.

Other integration repos:

  • langfuse-java: Java API client.
  • langfuse-cli: command-line API access.
  • mcp-server-langfuse: MCP prompt-management server.
  • n8n-nodes-langfuse: n8n prompt-management node.
  • experiment-action: GitHub Action for experiment workflows.
  • terraform-provider-langfuse: Terraform provider.

Deployment And Operations

infrastructure:

  • terraform/environments/**: environment-specific cloud resources.
  • terraform/modules/**: reusable Terraform modules.
  • terraform/org/**: organization-level configuration.
  • clickhouse/**: ClickHouse operations/configuration.
  • scripts/**: deployment, migration, consistency, performance, and infra utilities.
  • load-tests/**: infrastructure load tests.
  • .agents/skills/infra-scaling/SKILL.md: autoscaling and RPM/capacity workflow.

Deployment repos:

  • langfuse-k8s: Helm/Kubernetes chart and templates.
  • langfuse-terraform-aws: AWS module.
  • langfuse-terraform-gcp: GCP module.
  • langfuse-terraform-azure: Azure module.
  • oss-llmops-stack: reference OSS LLMOps stack using LiteLLM and Langfuse.

Skill Repositories

langfuse/skills public skill:

  • skills/langfuse/SKILL.md: docs/API/CLI/product-usage entrypoint.
  • References: cli.md, instrumentation.md, prompt-migration.md, sdk-upgrade.md, error-analysis.md, user-feedback.md, skill-feedback.md.

langfuse/langfuse-internal-skills internal skills:

  • blog-writing: Langfuse docs blog writing and editing.
  • langfuse-pr-funnel: feature announcement fanout drafts and draft PRs.
  • langfuse-support-triage: first-level support issue investigation and response drafting.
  • langfuse-support-weekly-review: weekly support/feedback trend review.
  • meeting-notes: calendar and Notion meeting notes, summaries, action items.
  • plain-search: Plain support ticket search/retrieval.
  • social-post-drafter: X/LinkedIn drafting for Langfuse.
  • unslop: concise rewrite in the user's direct style.
  • langfuse-codebase-navigator: this navigation skill.

Search Recipes

Main repo feature search:

bash
LANGFUSE_REPO_ROOT="$(git rev-parse --show-toplevel)"
LANGFUSE_PARENT="$(dirname "$LANGFUSE_REPO_ROOT")"

cd "$LANGFUSE_PARENT/langfuse"
rg -n "prompt|dataset|score|trace|observation|session|eval" web/src packages/shared/src worker/src

Docs search:

bash
cd "$LANGFUSE_PARENT/langfuse-docs"
rg -n "topic or feature name" content app components components-mdx cookbook

SDK search:

bash
cd "$LANGFUSE_PARENT/langfuse-js"
rg -n "observe|prompt|trace|span|score|dataset" packages tests

cd "$LANGFUSE_PARENT/langfuse-python"
rg -n "observe|prompt|trace|span|score|dataset" langfuse tests

Org search fallback:

bash
gh repo list langfuse --limit 1000 --json name,description,isPrivate,primaryLanguage,pushedAt,url
gh search code "query org:langfuse" --limit 50

Use private sparse-metadata repos only after inspecting their README/root files or when the user explicitly names them.