Automatic LLM observability for OpenCode using Langfuse via OpenTelemetry.

Zero-config tracing of sessions, messages, tool calls, costs, and performance.

npm install opencode-plugin-langfuse
# or
bun add opencode-plugin-langfuse

Sign up at cloud.langfuse.com and create a project.

Go to Settings → API Keys and copy your keys.

export LANGFUSE_PUBLIC_KEY="pk-lf-..."
export LANGFUSE_SECRET_KEY="sk-lf-..."
export LANGFUSE_BASEURL="https://cloud.langfuse.com"  # Optional

In .opencode/opencode.json:

{
  "experimental": {
    "openTelemetry": true
  },
  "plugin": ["opencode-plugin-langfuse"]
}

That's it! All traces appear automatically in your Langfuse dashboard.

This plugin initializes a LangfuseSpanProcessor that captures all OpenTelemetry spans emitted by OpenCode when experimental.openTelemetry is enabled.

OpenCode (OTEL spans) → LangfuseSpanProcessor → Langfuse Dashboard

export LANGFUSE_BASEURL="https://langfuse.yourcompany.com"

See Langfuse self-hosting docs.

1. Verify experimental.openTelemetry: true is set
2. Check credentials: echo $LANGFUSE_PUBLIC_KEY
3. Check Langfuse health: curl https://cloud.langfuse.com/api/public/health

• Ensure opencode-plugin-langfuse is in dependencies (not devDependencies)
• Verify .opencode/opencode.json syntax

MIT © omercnet

• OpenCode
• Langfuse
• Langfuse OTEL Integration