.agents/skills/langfuse-codebase-navigator/references/repository-map.md
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.
| Need | Start Here | Then Check |
|---|---|---|
| Product UI, API routes, tRPC, auth, billing, prompts, datasets, evals, traces, sessions, scores, models | langfuse/langfuse | web/src/features/**, web/src/pages/**, web/src/app/**, packages/shared/src/** |
| Ingestion, queues, async jobs, exports, retention, evaluation runners, background workers | langfuse/langfuse | worker/src/**, packages/shared/src/server/** |
| Shared domain types, repositories, services, Postgres/ClickHouse queries | langfuse/langfuse | packages/shared/src/domain/**, packages/shared/src/server/**, packages/shared/src/server/queries/** |
| Public API schema and generated server/client definitions | langfuse/langfuse | fern/apis/server/definition/**, fern/apis/client/definition/**, generated clients |
| Docs, changelog, blog, handbook, cookbook, integrations, website components | langfuse/langfuse-docs | content/**, app/**, components/**, components-mdx/**, cookbook/** |
| JS/TS SDKs and integrations | langfuse/langfuse-js | packages/client, packages/core, packages/tracing, packages/otel, packages/openai, packages/langchain |
| Python SDK | langfuse/langfuse-python | langfuse/**, langfuse/api/**, tests/** |
| Java SDK | langfuse/langfuse-java | Generated Java client and tests |
| Cloud infrastructure, Terraform, ClickHouse operations, load tests, infra scripts | langfuse/infrastructure | terraform/**, clickhouse/**, scripts/**, load-tests/** |
| Kubernetes / Helm deployment | langfuse/langfuse-k8s | Helm chart and Kubernetes templates |
| Terraform deployment modules | langfuse/langfuse-terraform-aws, langfuse/langfuse-terraform-gcp, langfuse/langfuse-terraform-azure | Provider-specific module files |
| Terraform provider | langfuse/terraform-provider-langfuse | Provider resources, generated schema, tests |
| Public agent skill for using Langfuse | langfuse/skills | skills/langfuse/SKILL.md and its references |
| Internal Langfuse team skills | langfuse/langfuse-internal-skills | Top-level skill folders in this repo |
| CLI | langfuse/langfuse-cli | src/**, bin/**, openapi.yml |
| MCP prompt-management server | langfuse/mcp-server-langfuse | src/** |
| n8n node | langfuse/n8n-nodes-langfuse | Node package source |
| GitHub Action for experiments | langfuse/experiment-action | action.yml, src/**, schemas/** |
| Examples | langfuse/langfuse-examples | Example app directories |
| API reference site | langfuse/langfuse-api-reference | Static/generated API reference assets |
| Repo | Visibility | Language | Route When |
|---|---|---|---|
.github | Public | n/a | Organization profile, default community health, org-wide GitHub metadata. |
202604-offsite-slides | Private | TypeScript | Internal offsite slide deck work. Only route here when the user names it or asks for those slides. |
analytics | Private | Shell | Analytic data pipeline and documentation, cost/data marts, analytics scripts. |
background-jobs | Private | TypeScript | Sparse metadata, older private background-job work. Inspect README before using. |
experiment-action | Public | TypeScript | GitHub Action workflow support for running Langfuse experiments. |
infrastructure | Private | HCL | Langfuse Cloud infrastructure, Terraform, ClickHouse ops, infra scripts, load tests. |
langfuse | Public | TypeScript | Main product monorepo: web app, API, worker, shared packages, generated API definitions. |
langfuse-api-reference | Public | HTML | Generated or static API reference site. |
langfuse-cli | Public | TypeScript | CLI wrapper around Langfuse API. |
langfuse-docs | Public | MDX | Docs, changelog, blog, integrations, cookbook, handbook, marketing/docs website. |
langfuse-examples | Public | TypeScript | Example apps showing deployment and Langfuse usage. |
langfuse-ghsa-gccw-7cqr-2cjm | Private | TypeScript | Security advisory remediation/reproduction work for that GHSA. Treat as sensitive. |
langfuse-internal-skills | Private | Python | Internal team skills for support, PR funnel, social copy, meeting notes, Plain search, writing, and routing. |
langfuse-java | Public | Java | Auto-generated Java client for the Langfuse API. |
langfuse-js | Public | TypeScript | JS/TS SDK packages and integrations for tracing, OpenAI, LangChain, OTel, prompts, datasets, scores. |
langfuse-k8s | Public | Go Template | Community-maintained Kubernetes config and Helm chart. |
langfuse-ops | Private | JavaScript | Private ops utilities. Inspect README/scripts before using. |
langfuse-playground | Private | Python | Private playground/prototype code. Use when named or search evidence points here. |
langfuse-python | Public | Python | Python SDK, generated API client, decorators, OTel, LangChain/OpenAI integration tests. |
langfuse-terraform-aws | Public | HCL | Terraform module for AWS deployment. |
langfuse-terraform-azure | Public | HCL | Terraform module for Azure deployment. |
langfuse-terraform-gcp | Public | HCL | Terraform module for GCP deployment. |
mcp-server-langfuse | Public | TypeScript | MCP server for Langfuse prompt management. |
n8n-nodes-langfuse | Public | JavaScript | n8n node for Langfuse prompt management. |
nofilter | Private | TypeScript | Hackathon/prototype repo. Use only when named or search evidence points here. |
oss-llmops-stack | Public | n/a | Modular OSS LLMOps stack combining LiteLLM and Langfuse. |
platform | Private | Python | Sparse metadata, private platform repo. Inspect README before routing non-obvious work here. |
skills | Public | Python | Public installable Langfuse agent skill for using Langfuse and its docs/API. |
task-search-bar | Private | TypeScript | Small private task/prototype repo. Use when named. |
terraform-provider-langfuse | Public | Go | Terraform provider for managing Langfuse resources. |
tmp-langfuse-otel-js | Private | TypeScript | Temporary repo for new JS SDK v4 / OTel work. Check whether work has moved to langfuse-js. |
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-practicesvercel-composition-patternsStart 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.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.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.langfuse/skills public skill:
skills/langfuse/SKILL.md: docs/API/CLI/product-usage entrypoint.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.Main repo feature search:
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:
cd "$LANGFUSE_PARENT/langfuse-docs"
rg -n "topic or feature name" content app components components-mdx cookbook
SDK search:
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:
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.