[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F7R4BT3HTN5MSKQYASMBCE":3,"skill-same:01M6F7R4BT3HTN5MSKQYASMBCE":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":51,"commitSha":52,"skillDirectory":53,"forksCount":54,"repositoryHtmlUrl":55,"repositoryHomepageUrl":6,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":73},"01M6F7R4BT3HTN5MSKQYASMBCE","langfuse-multi-env-setup",null,"Configure Langfuse across development, staging, and production environments.\nUse when setting up multi-environment deployments, configuring per-environment keys,\nor implementing environment-specific Langfuse configurations.\nTrigger with phrases like \"langfuse environments\", \"langfuse staging\",\n\"langfuse dev prod\", \"langfuse environment setup\", \"langfuse config by env\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1981,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flangfuse-pack\u002Fskills\u002Flangfuse-multi-env-setup\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"setup","langfuse","langfuse multi env setup","multi","env setup","env","when","config","implementing","environments","trigger","io","across","multi-environment","up","environment","edit","write","read","configure","Bash","dev","development","2026-11-10 10:12:30",false,"---\nname: langfuse-multi-env-setup\ndescription: |\n  Configure Langfuse across development, staging, and production environments.\n  Use when setting up multi-environment deployments, configuring per-environment keys,\n  or implementing environment-specific Langfuse configurations.\n  Trigger with phrases like \"langfuse environments\", \"langfuse staging\",\n  \"langfuse dev prod\", \"langfuse environment setup\", \"langfuse config by env\".\nallowed-tools: Read, Write, Edit, Bash(aws:*), Bash(gcloud:*), Bash(vault:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# Langfuse Multi-Environment Setup\n\n## Overview\nConfigure Langfuse across development, staging, and production environments.\n\n## Prerequisites\n- Separate Langfuse projects or API keys per environment\n- Secret management solution (Vault, AWS Secrets Manager, etc.)\n- CI\u002FCD pipeline with environment variables\n- Environment detection in application\n\n## Environment Strategy\n\n| Environment | Purpose | API Keys | Sampling |\n|-------------|---------|----------|----------|\n| Development | Local dev | Dev project | 100% |\n| Staging | Pre-prod validation | Staging project | 50% |\n| Production | Live traffic | Production project | 10-100% |\n\n## Instructions\n\n### Step 1: Create Configuration Structure\n\n```\nconfig\u002F\n├── langfuse\u002F\n│   ├── base.ts           # Shared config\n│   ├── development.ts    # Dev overrides\n│   ├── staging.ts        # Staging overrides\n│   └── production.ts     # Prod overrides\n```\n\n### Step 2: Implement Base Configuration\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fbase.ts\nexport interface LangfuseConfig {\n  publicKey: string;\n  secretKey: string;\n  host: string;\n  enabled: boolean;\n  flushAt: number;\n  flushInterval: number;\n  requestTimeout: number;\n  sampling: {\n    rate: number;\n    alwaysSampleErrors: boolean;\n    alwaysSampleSlowTraces: boolean;\n    slowTraceThresholdMs: number;\n  };\n  piiScrubbing: {\n    enabled: boolean;\n    fields: string[];\n  };\n}\n\nexport const baseConfig: Partial\u003CLangfuseConfig> = {\n  host: \"https:\u002F\u002Fcloud.langfuse.com\",\n  requestTimeout: 15000,\n  sampling: {\n    rate: 1.0,\n    alwaysSampleErrors: true,\n    alwaysSampleSlowTraces: true,\n    slowTraceThresholdMs: 5000,\n  },\n  piiScrubbing: {\n    enabled: true,\n    fields: [\"email\", \"password\", \"ssn\", \"creditCard\", \"phone\"],\n  },\n};\n```\n\n### Step 3: Create Environment-Specific Configs\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fdevelopment.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const developmentConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_DEV!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_DEV!,\n  host: process.env.LANGFUSE_HOST_DEV || \"http:\u002F\u002Flocalhost:3000\",\n  enabled: true,\n  flushAt: 1,           \u002F\u002F Immediate flush for debugging\n  flushInterval: 1000,  \u002F\u002F 1 second\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: 1.0,          \u002F\u002F Sample everything in dev\n  },\n  piiScrubbing: {\n    ...baseConfig.piiScrubbing!,\n    enabled: false,     \u002F\u002F Disable for debugging\n  },\n} as LangfuseConfig;\n```\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fstaging.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const stagingConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_STAGING!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_STAGING!,\n  host: process.env.LANGFUSE_HOST_STAGING || \"https:\u002F\u002Fcloud.langfuse.com\",\n  enabled: true,\n  flushAt: 15,\n  flushInterval: 5000,\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: 0.5,          \u002F\u002F 50% sampling in staging\n  },\n} as LangfuseConfig;\n```\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fproduction.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const productionConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_PROD!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_PROD!,\n  host: process.env.LANGFUSE_HOST || \"https:\u002F\u002Fcloud.langfuse.com\",\n  enabled: true,\n  flushAt: 25,\n  flushInterval: 5000,\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: parseFloat(process.env.LANGFUSE_SAMPLE_RATE || \"0.1\"),\n  },\n} as LangfuseConfig;\n```\n\n### Step 4: Environment Detection and Config Loading\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Findex.ts\nimport { LangfuseConfig } from \".\u002Fbase\";\nimport { developmentConfig } from \".\u002Fdevelopment\";\nimport { stagingConfig } from \".\u002Fstaging\";\nimport { productionConfig } from \".\u002Fproduction\";\n\ntype Environment = \"development\" | \"staging\" | \"production\";\n\nconst configs: Record\u003CEnvironment, LangfuseConfig> = {\n  development: developmentConfig,\n  staging: stagingConfig,\n  production: productionConfig,\n};\n\nfunction detectEnvironment(): Environment {\n  \u002F\u002F Check explicit environment variable\n  const explicitEnv = process.env.LANGFUSE_ENV as Environment;\n  if (explicitEnv && configs[explicitEnv]) {\n    return explicitEnv;\n  }\n\n  \u002F\u002F Fall back to NODE_ENV\n  const nodeEnv = process.env.NODE_ENV;\n\n  if (nodeEnv === \"production\") {\n    \u002F\u002F Distinguish staging from production\n    if (\n      process.env.VERCEL_ENV === \"preview\" ||\n      process.env.DEPLOYMENT_ENV === \"staging\"\n    ) {\n      return \"staging\";\n    }\n    return \"production\";\n  }\n\n  return \"development\";\n}\n\nexport function getLangfuseConfig(): LangfuseConfig & { environment: Environment } {\n  const environment = detectEnvironment();\n  const config = configs[environment];\n\n  \u002F\u002F Validate required fields\n  if (!config.publicKey || !config.secretKey) {\n    console.warn(\n      `Langfuse: Missing credentials for ${environment} environment`\n    );\n  }\n\n  return {\n    ...config,\n    environment,\n  };\n}\n\n\u002F\u002F Singleton export\nlet cachedConfig: ReturnType\u003Ctypeof getLangfuseConfig> | null = null;\n\nexport function getConfig(): ReturnType\u003Ctypeof getLangfuseConfig> {\n  if (!cachedConfig) {\n    cachedConfig = getLangfuseConfig();\n    console.log(`Langfuse: Loaded ${cachedConfig.environment} configuration`);\n  }\n  return cachedConfig;\n}\n```\n\n### Step 5: Create Environment-Aware Langfuse Client\n\n```typescript\n\u002F\u002F lib\u002Flangfuse.ts\nimport { Langfuse } from \"langfuse\";\nimport { getConfig, LangfuseConfig } from \"..\u002Fconfig\u002Flangfuse\";\n\nclass LangfuseFactory {\n  private static instance: Langfuse | null = null;\n  private static config: LangfuseConfig | null = null;\n\n  static getInstance(): Langfuse {\n    if (!LangfuseFactory.instance) {\n      const config = getConfig();\n      LangfuseFactory.config = config;\n\n      if (!config.enabled) {\n        console.log(\"Langfuse: Disabled by configuration\");\n        return LangfuseFactory.createNoOpClient();\n      }\n\n      LangfuseFactory.instance = new Langfuse({\n        publicKey: config.publicKey,\n        secretKey: config.secretKey,\n        baseUrl: config.host,\n        flushAt: config.flushAt,\n        flushInterval: config.flushInterval,\n        requestTimeout: config.requestTimeout,\n      });\n\n      LangfuseFactory.registerShutdown();\n    }\n\n    return LangfuseFactory.instance!;\n  }\n\n  static getConfig(): LangfuseConfig | null {\n    return LangfuseFactory.config;\n  }\n\n  private static createNoOpClient(): Langfuse {\n    \u002F\u002F Return a mock that does nothing\n    return {\n      trace: () => LangfuseFactory.createNoOpTrace(),\n      flushAsync: async () => {},\n      shutdownAsync: async () => {},\n    } as unknown as Langfuse;\n  }\n\n  private static createNoOpTrace() {\n    return {\n      id: \"noop\",\n      span: () => LangfuseFactory.createNoOpTrace(),\n      generation: () => ({ id: \"noop\", end: () => {} }),\n      update: () => {},\n      getTraceUrl: () => \"\",\n    };\n  }\n\n  private static registerShutdown() {\n    const shutdown = async () => {\n      if (LangfuseFactory.instance) {\n        console.log(\"Langfuse: Shutting down...\");\n        await LangfuseFactory.instance.shutdownAsync();\n        LangfuseFactory.instance = null;\n      }\n    };\n\n    process.on(\"SIGTERM\", shutdown);\n    process.on(\"SIGINT\", shutdown);\n  }\n}\n\nexport const langfuse = LangfuseFactory.getInstance();\nexport const langfuseConfig = LangfuseFactory.getConfig();\n```\n\n### Step 6: Secret Management Integration\n\n```typescript\n\u002F\u002F lib\u002Fsecrets\u002Flangfuse.ts\nimport { SecretsManagerClient, GetSecretValueCommand } from \"@aws-sdk\u002Fclient-secrets-manager\";\nimport { SecretManagerServiceClient } from \"@google-cloud\u002Fsecret-manager\";\n\ntype SecretProvider = \"aws\" | \"gcp\" | \"vault\" | \"env\";\n\ninterface LangfuseSecrets {\n  publicKey: string;\n  secretKey: string;\n}\n\nasync function getSecretsFromAWS(secretName: string): Promise\u003CLangfuseSecrets> {\n  const client = new SecretsManagerClient({});\n  const response = await client.send(\n    new GetSecretValueCommand({ SecretId: secretName })\n  );\n  return JSON.parse(response.SecretString!);\n}\n\nasync function getSecretsFromGCP(secretPath: string): Promise\u003CLangfuseSecrets> {\n  const client = new SecretManagerServiceClient();\n  const [publicKeyVersion] = await client.accessSecretVersion({\n    name: `${secretPath}\u002Flangfuse-public-key\u002Fversions\u002Flatest`,\n  });\n  const [secretKeyVersion] = await client.accessSecretVersion({\n    name: `${secretPath}\u002Flangfuse-secret-key\u002Fversions\u002Flatest`,\n  });\n\n  return {\n    publicKey: publicKeyVersion.payload?.data?.toString() || \"\",\n    secretKey: secretKeyVersion.payload?.data?.toString() || \"\",\n  };\n}\n\nexport async function getLangfuseSecrets(\n  provider: SecretProvider = \"env\",\n  options?: { secretName?: string; secretPath?: string }\n): Promise\u003CLangfuseSecrets> {\n  switch (provider) {\n    case \"aws\":\n      return getSecretsFromAWS(\n        options?.secretName || `langfuse\u002F${process.env.NODE_ENV}`\n      );\n\n    case \"gcp\":\n      return getSecretsFromGCP(\n        options?.secretPath || `projects\u002F${process.env.GCP_PROJECT}\u002Fsecrets`\n      );\n\n    case \"env\":\n    default:\n      return {\n        publicKey: process.env.LANGFUSE_PUBLIC_KEY!,\n        secretKey: process.env.LANGFUSE_SECRET_KEY!,\n      };\n  }\n}\n```\n\n## Output\n- Multi-environment configuration structure\n- Environment detection logic\n- Environment-aware Langfuse client\n- Secret management integration\n- Graceful degradation when disabled\n\n## Environment Variables Reference\n\n```bash\n# Development\nLANGFUSE_PUBLIC_KEY_DEV=pk-lf-dev-...\nLANGFUSE_SECRET_KEY_DEV=sk-lf-dev-...\nLANGFUSE_HOST_DEV=http:\u002F\u002Flocalhost:3000\n\n# Staging\nLANGFUSE_PUBLIC_KEY_STAGING=pk-lf-staging-...\nLANGFUSE_SECRET_KEY_STAGING=sk-lf-staging-...\nLANGFUSE_HOST_STAGING=https:\u002F\u002Fcloud.langfuse.com\n\n# Production\nLANGFUSE_PUBLIC_KEY_PROD=pk-lf-prod-...\nLANGFUSE_SECRET_KEY_PROD=sk-lf-prod-...\nLANGFUSE_HOST=https:\u002F\u002Fcloud.langfuse.com\nLANGFUSE_SAMPLE_RATE=0.1\n\n# Override environment detection\nLANGFUSE_ENV=staging\n```\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Wrong environment | Missing NODE_ENV | Set environment variable |\n| Secret not found | Wrong secret path | Verify secret manager config |\n| Config merge fails | Invalid values | Validate config on load |\n| Cross-env data leak | Shared keys | Use separate projects per env |\n\n## Resources\n- [Langfuse Projects](https:\u002F\u002Flangfuse.com\u002Fdocs)\n- [12-Factor App Config](https:\u002F\u002F12factor.net\u002Fconfig)\n- [AWS Secrets Manager](https:\u002F\u002Faws.amazon.com\u002Fsecrets-manager\u002F)\n- [GCP Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\nFor observability setup, see `langfuse-observability`.\n","# Langfuse Multi-Environment Setup\n\n## Overview\nConfigure Langfuse across development, staging, and production environments.\n\n## Prerequisites\n- Separate Langfuse projects or API keys per environment\n- Secret management solution (Vault, AWS Secrets Manager, etc.)\n- CI\u002FCD pipeline with environment variables\n- Environment detection in application\n\n## Environment Strategy\n\n| Environment | Purpose | API Keys | Sampling |\n|-------------|---------|----------|----------|\n| Development | Local dev | Dev project | 100% |\n| Staging | Pre-prod validation | Staging project | 50% |\n| Production | Live traffic | Production project | 10-100% |\n\n## Instructions\n\n### Step 1: Create Configuration Structure\n\n```\nconfig\u002F\n├── langfuse\u002F\n│   ├── base.ts           # Shared config\n│   ├── development.ts    # Dev overrides\n│   ├── staging.ts        # Staging overrides\n│   └── production.ts     # Prod overrides\n```\n\n### Step 2: Implement Base Configuration\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fbase.ts\nexport interface LangfuseConfig {\n  publicKey: string;\n  secretKey: string;\n  host: string;\n  enabled: boolean;\n  flushAt: number;\n  flushInterval: number;\n  requestTimeout: number;\n  sampling: {\n    rate: number;\n    alwaysSampleErrors: boolean;\n    alwaysSampleSlowTraces: boolean;\n    slowTraceThresholdMs: number;\n  };\n  piiScrubbing: {\n    enabled: boolean;\n    fields: string[];\n  };\n}\n\nexport const baseConfig: Partial\u003CLangfuseConfig> = {\n  host: \"https:\u002F\u002Fcloud.langfuse.com\",\n  requestTimeout: 15000,\n  sampling: {\n    rate: 1.0,\n    alwaysSampleErrors: true,\n    alwaysSampleSlowTraces: true,\n    slowTraceThresholdMs: 5000,\n  },\n  piiScrubbing: {\n    enabled: true,\n    fields: [\"email\", \"password\", \"ssn\", \"creditCard\", \"phone\"],\n  },\n};\n```\n\n### Step 3: Create Environment-Specific Configs\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fdevelopment.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const developmentConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_DEV!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_DEV!,\n  host: process.env.LANGFUSE_HOST_DEV || \"http:\u002F\u002Flocalhost:3000\",\n  enabled: true,\n  flushAt: 1,           \u002F\u002F Immediate flush for debugging\n  flushInterval: 1000,  \u002F\u002F 1 second\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: 1.0,          \u002F\u002F Sample everything in dev\n  },\n  piiScrubbing: {\n    ...baseConfig.piiScrubbing!,\n    enabled: false,     \u002F\u002F Disable for debugging\n  },\n} as LangfuseConfig;\n```\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fstaging.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const stagingConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_STAGING!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_STAGING!,\n  host: process.env.LANGFUSE_HOST_STAGING || \"https:\u002F\u002Fcloud.langfuse.com\",\n  enabled: true,\n  flushAt: 15,\n  flushInterval: 5000,\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: 0.5,          \u002F\u002F 50% sampling in staging\n  },\n} as LangfuseConfig;\n```\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Fproduction.ts\nimport { LangfuseConfig, baseConfig } from \".\u002Fbase\";\n\nexport const productionConfig: LangfuseConfig = {\n  ...baseConfig,\n  publicKey: process.env.LANGFUSE_PUBLIC_KEY_PROD!,\n  secretKey: process.env.LANGFUSE_SECRET_KEY_PROD!,\n  host: process.env.LANGFUSE_HOST || \"https:\u002F\u002Fcloud.langfuse.com\",\n  enabled: true,\n  flushAt: 25,\n  flushInterval: 5000,\n  sampling: {\n    ...baseConfig.sampling!,\n    rate: parseFloat(process.env.LANGFUSE_SAMPLE_RATE || \"0.1\"),\n  },\n} as LangfuseConfig;\n```\n\n### Step 4: Environment Detection and Config Loading\n\n```typescript\n\u002F\u002F config\u002Flangfuse\u002Findex.ts\nimport { LangfuseConfig } from \".\u002Fbase\";\nimport { developmentConfig } from \".\u002Fdevelopment\";\nimport { stagingConfig } from \".\u002Fstaging\";\nimport { productionConfig } from \".\u002Fproduction\";\n\ntype Environment = \"development\" | \"staging\" | \"production\";\n\nconst configs: Record\u003CEnvironment, LangfuseConfig> = {\n  development: developmentConfig,\n  staging: stagingConfig,\n  production: productionConfig,\n};\n\nfunction detectEnvironment(): Environment {\n  \u002F\u002F Check explicit environment variable\n  const explicitEnv = process.env.LANGFUSE_ENV as Environment;\n  if (explicitEnv && configs[explicitEnv]) {\n    return explicitEnv;\n  }\n\n  \u002F\u002F Fall back to NODE_ENV\n  const nodeEnv = process.env.NODE_ENV;\n\n  if (nodeEnv === \"production\") {\n    \u002F\u002F Distinguish staging from production\n    if (\n      process.env.VERCEL_ENV === \"preview\" ||\n      process.env.DEPLOYMENT_ENV === \"staging\"\n    ) {\n      return \"staging\";\n    }\n    return \"production\";\n  }\n\n  return \"development\";\n}\n\nexport function getLangfuseConfig(): LangfuseConfig & { environment: Environment } {\n  const environment = detectEnvironment();\n  const config = configs[environment];\n\n  \u002F\u002F Validate required fields\n  if (!config.publicKey || !config.secretKey) {\n    console.warn(\n      `Langfuse: Missing credentials for ${environment} environment`\n    );\n  }\n\n  return {\n    ...config,\n    environment,\n  };\n}\n\n\u002F\u002F Singleton export\nlet cachedConfig: ReturnType\u003Ctypeof getLangfuseConfig> | null = null;\n\nexport function getConfig(): ReturnType\u003Ctypeof getLangfuseConfig> {\n  if (!cachedConfig) {\n    cachedConfig = getLangfuseConfig();\n    console.log(`Langfuse: Loaded ${cachedConfig.environment} configuration`);\n  }\n  return cachedConfig;\n}\n```\n\n### Step 5: Create Environment-Aware Langfuse Client\n\n```typescript\n\u002F\u002F lib\u002Flangfuse.ts\nimport { Langfuse } from \"langfuse\";\nimport { getConfig, LangfuseConfig } from \"..\u002Fconfig\u002Flangfuse\";\n\nclass LangfuseFactory {\n  private static instance: Langfuse | null = null;\n  private static config: LangfuseConfig | null = null;\n\n  static getInstance(): Langfuse {\n    if (!LangfuseFactory.instance) {\n      const config = getConfig();\n      LangfuseFactory.config = config;\n\n      if (!config.enabled) {\n        console.log(\"Langfuse: Disabled by configuration\");\n        return LangfuseFactory.createNoOpClient();\n      }\n\n      LangfuseFactory.instance = new Langfuse({\n        publicKey: config.publicKey,\n        secretKey: config.secretKey,\n        baseUrl: config.host,\n        flushAt: config.flushAt,\n        flushInterval: config.flushInterval,\n        requestTimeout: config.requestTimeout,\n      });\n\n      LangfuseFactory.registerShutdown();\n    }\n\n    return LangfuseFactory.instance!;\n  }\n\n  static getConfig(): LangfuseConfig | null {\n    return LangfuseFactory.config;\n  }\n\n  private static createNoOpClient(): Langfuse {\n    \u002F\u002F Return a mock that does nothing\n    return {\n      trace: () => LangfuseFactory.createNoOpTrace(),\n      flushAsync: async () => {},\n      shutdownAsync: async () => {},\n    } as unknown as Langfuse;\n  }\n\n  private static createNoOpTrace() {\n    return {\n      id: \"noop\",\n      span: () => LangfuseFactory.createNoOpTrace(),\n      generation: () => ({ id: \"noop\", end: () => {} }),\n      update: () => {},\n      getTraceUrl: () => \"\",\n    };\n  }\n\n  private static registerShutdown() {\n    const shutdown = async () => {\n      if (LangfuseFactory.instance) {\n        console.log(\"Langfuse: Shutting down...\");\n        await LangfuseFactory.instance.shutdownAsync();\n        LangfuseFactory.instance = null;\n      }\n    };\n\n    process.on(\"SIGTERM\", shutdown);\n    process.on(\"SIGINT\", shutdown);\n  }\n}\n\nexport const langfuse = LangfuseFactory.getInstance();\nexport const langfuseConfig = LangfuseFactory.getConfig();\n```\n\n### Step 6: Secret Management Integration\n\n```typescript\n\u002F\u002F lib\u002Fsecrets\u002Flangfuse.ts\nimport { SecretsManagerClient, GetSecretValueCommand } from \"@aws-sdk\u002Fclient-secrets-manager\";\nimport { SecretManagerServiceClient } from \"@google-cloud\u002Fsecret-manager\";\n\ntype SecretProvider = \"aws\" | \"gcp\" | \"vault\" | \"env\";\n\ninterface LangfuseSecrets {\n  publicKey: string;\n  secretKey: string;\n}\n\nasync function getSecretsFromAWS(secretName: string): Promise\u003CLangfuseSecrets> {\n  const client = new SecretsManagerClient({});\n  const response = await client.send(\n    new GetSecretValueCommand({ SecretId: secretName })\n  );\n  return JSON.parse(response.SecretString!);\n}\n\nasync function getSecretsFromGCP(secretPath: string): Promise\u003CLangfuseSecrets> {\n  const client = new SecretManagerServiceClient();\n  const [publicKeyVersion] = await client.accessSecretVersion({\n    name: `${secretPath}\u002Flangfuse-public-key\u002Fversions\u002Flatest`,\n  });\n  const [secretKeyVersion] = await client.accessSecretVersion({\n    name: `${secretPath}\u002Flangfuse-secret-key\u002Fversions\u002Flatest`,\n  });\n\n  return {\n    publicKey: publicKeyVersion.payload?.data?.toString() || \"\",\n    secretKey: secretKeyVersion.payload?.data?.toString() || \"\",\n  };\n}\n\nexport async function getLangfuseSecrets(\n  provider: SecretProvider = \"env\",\n  options?: { secretName?: string; secretPath?: string }\n): Promise\u003CLangfuseSecrets> {\n  switch (provider) {\n    case \"aws\":\n      return getSecretsFromAWS(\n        options?.secretName || `langfuse\u002F${process.env.NODE_ENV}`\n      );\n\n    case \"gcp\":\n      return getSecretsFromGCP(\n        options?.secretPath || `projects\u002F${process.env.GCP_PROJECT}\u002Fsecrets`\n      );\n\n    case \"env\":\n    default:\n      return {\n        publicKey: process.env.LANGFUSE_PUBLIC_KEY!,\n        secretKey: process.env.LANGFUSE_SECRET_KEY!,\n      };\n  }\n}\n```\n\n## Output\n- Multi-environment configuration structure\n- Environment detection logic\n- Environment-aware Langfuse client\n- Secret management integration\n- Graceful degradation when disabled\n\n## Environment Variables Reference\n\n```bash\n# Development\nLANGFUSE_PUBLIC_KEY_DEV=pk-lf-dev-...\nLANGFUSE_SECRET_KEY_DEV=sk-lf-dev-...\nLANGFUSE_HOST_DEV=http:\u002F\u002Flocalhost:3000\n\n# Staging\nLANGFUSE_PUBLIC_KEY_STAGING=pk-lf-staging-...\nLANGFUSE_SECRET_KEY_STAGING=sk-lf-staging-...\nLANGFUSE_HOST_STAGING=https:\u002F\u002Fcloud.langfuse.com\n\n# Production\nLANGFUSE_PUBLIC_KEY_PROD=pk-lf-prod-...\nLANGFUSE_SECRET_KEY_PROD=sk-lf-prod-...\nLANGFUSE_HOST=https:\u002F\u002Fcloud.langfuse.com\nLANGFUSE_SAMPLE_RATE=0.1\n\n# Override environment detection\nLANGFUSE_ENV=staging\n```\n\n## Error Handling\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Wrong environment | Missing NODE_ENV | Set environment variable |\n| Secret not found | Wrong secret path | Verify secret manager config |\n| Config merge fails | Invalid values | Validate config on load |\n| Cross-env data leak | Shared keys | Use separate projects per env |\n\n## Resources\n- [Langfuse Projects](https:\u002F\u002Flangfuse.com\u002Fdocs)\n- [12-Factor App Config](https:\u002F\u002F12factor.net\u002Fconfig)\n- [AWS Secrets Manager](https:\u002F\u002Faws.amazon.com\u002Fsecrets-manager\u002F)\n- [GCP Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\nFor observability setup, see `langfuse-observability`.\n",{"name":5,"author":47,"license":15,"version":48,"description":49,"allowed-tools":50},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Configure Langfuse across development, staging, and production environments.\nUse when setting up multi-environment deployments, configuring per-environment keys,\nor implementing environment-specific Langfuse configurations.\nTrigger with phrases like \"langfuse environments\", \"langfuse staging\",\n\"langfuse dev prod\", \"langfuse environment setup\", \"langfuse config by env\".\n","Read, Write, Edit, Bash(aws:*), Bash(gcloud:*), Bash(vault:*)","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flangfuse-pack\u002Fskills\u002Flangfuse-multi-env-setup",231,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-12 03:15:57",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill langfuse-multi-env-setup",{"tool":66,"command":67},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill langfuse-multi-env-setup",{"tool":69,"command":70},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill langfuse-multi-env-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Flangfuse-pack\u002Fskills\u002Flangfuse-multi-env-setup\u002FSKILL.md",true,[],[75,115,140,166,193,215],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":88,"publishedAt":42},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[83],{"categoryNo":84,"categoryName":85,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,22,112,113,114],"web artifacts builder","web","artifacts","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","use","html","single-file","simple","ui components","for","jsx","suite",{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":119,"sourceHtmlUrl":120,"categories":121,"keywords":126,"publishedAt":42},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[122,125],{"categoryNo":123,"categoryName":124,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":84,"categoryName":85,"taxonomyType":86,"taxonomyTypeDesc":87},[127,128,129,94,130,131,90,132,133,134,104,135,136,137,138,139,112],"testing","webapp testing","webapp","screenshots","playwright","debugging","toolkit","browser","logs","applications","behavior","local","with",{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":144,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":42},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[148,149,150,151,152,153,154,155,107,156,157,158,159,160,161,162,139,163,164,165,112,25],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":170,"sourceHtmlUrl":171,"categories":172,"keywords":176,"publishedAt":42},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[173],{"categoryNo":174,"categoryName":175,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000023","Skill与智能体开发",[177,178,179,180,181,182,183,184,185,186,187,188,189,190,139,112,191,25,192],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":197,"sourceHtmlUrl":198,"categories":199,"keywords":201,"publishedAt":42},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[200],{"categoryNo":174,"categoryName":175,"taxonomyType":86,"taxonomyTypeDesc":87},[195,202,203,204,205,206,207,134,208,209,107,210,211,212,213,112,214],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source",{"skillNo":216,"name":217,"nameZh":6,"description":218,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":79,"licenseFileUrl":219,"sourceHtmlUrl":220,"categories":221,"keywords":228,"publishedAt":42},"01M6FDHPXE10J3XGTCH5HBHS1M","slack-gif-creator","Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like \"make me a GIF of X doing Y for Slack.\"","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fenterprise-communication\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fenterprise-communication\u002Fslack-gif-creator\u002FSKILL.md",[222,225],{"categoryNo":223,"categoryName":224,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000005","邮件与沟通",{"categoryNo":226,"categoryName":227,"taxonomyType":86,"taxonomyTypeDesc":87},"01JBSEEDCAT000000000000016","图像与多媒体",[229,230,231,178,232,105,233,234,183,107,235,190,236,237,238,112,239,25],"slack gif creator","slack","gif","validation","constraints","Animation","me","make","Utilities","concepts","request"]