Skip to content

bug: Scores section in cli.md references non-existent CLI commands #2

@toyayuto

Description

@toyayuto

Body

Problem

The Scores section in skills/langfuse/references/cli.md lists commands that don't exist in the actual langfuse-cli:

# Currently documented
langfuse api scores list --limit 20      # "list" does not exist
langfuse api score-configs list          # "list" does not exist

Running langfuse api scores --help shows only create and delete — there is no list or get subcommand.
Similarly, langfuse api score-configs --help has get-public, not list.

This causes AI agents using the skill to waste many tool calls trying to find how to retrieve scores.

Expected (verified commands)

Verified by running npx langfuse-cli (v0.0.5-beta.0, latest on npm as of 2026-02-17):

# Score list/get — use score-v2s, not scores
langfuse api score-v2s get-scores --limit 20
langfuse api score-v2s get-get-by-id <score-id>

# Score configs — use get-public, not list
langfuse api score-configs get-public

Full verification

$ langfuse api scores --help
→ Commands: create, delete (no list/get)

$ langfuse api score-v2s --help
→ Commands: get-scores, get-get-by-id

$ langfuse api score-v2s get-scores --limit 3 --json
→ Successfully returns score data (value, comment, traceId, etc.)

$ langfuse api score-configs --help
→ Commands: create, get-get-by-id, get-public, update (no "list")

Additional context

  • The Tips section already recommends observations-v2s and metrics-v2s over their v1 counterparts, but score-v2s is missing from this list.
  • The langfuse-cli README (langfuse/langfuse-cli) also documents langfuse api scores list --limit 20 — the same issue exists there.
  • I've prepared a draft PR with a fix: fix: correct scores CLI commands in reference #1

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions