Skip to content

lf 0.4.0

Choose a tag to compare

@tns15june tns15june released this 25 Oct 15:28
· 5 commits to main since this release

Ask in plain English

Your coding agent now answers questions like "Why did my LLM app fail in the last hour?", "What did we spend on each model this week?" and "Which step of my agent is the slowest?" from your Langfuse data. The skill was rewritten around the questions people ask, with agent examples for each kind of question. In a test, ten fresh Claude Code sessions with only the skill installed each answered a different question correctly.

What's new

  • lf metrics: cost, tokens, latency percentiles, error counts and scores, aggregated over a time range (--metric, --by, --where, --granularity, --from-ts/--to-ts, --order-by, --limit, --view). It uses Langfuse's metrics API and was run against Langfuse 4.30 and 4.70.
  • One-line install on macOS and Linux: curl -fsSL https://tns15june.github.io/langfuse-agent-cli/install.sh | sh. It installs lf with uv or pipx (installing uv first when you have neither) and runs lf setup.
  • Agent install guide: tell your agent "Install langfuse-agent-cli using https://tns15june.github.io/langfuse-agent-cli/AGENTS.md". The guide follows the rules agents need: never handle keys, run lf setup --yes, ask before removing or upgrading.
  • lf upgrade upgrades lf with the tool that installed it, then installs the matching skill. lf uninstall removes the skill, the saved profiles and lf itself; --dry-run shows the list first, and it judges the skill removal by what is left on disk.
  • lf setup is safe to run again: it keeps working credentials, skips a skill that is already installed for this version, takes --profile-name for a second Langfuse instance (the new profile becomes the current one), and ends with questions to try.
  • lf doctor shows where lf is installed, whether a newer version is on PyPI (or why it could not check), and whether the installed skill matches your lf version.

Also

  • lf metrics rejects a filter value of the wrong kind before asking the server, and says on stderr when it used the default 24-hour window.
  • Ctrl-C at any lf prompt ends quietly; Ctrl-D means "no".
  • Commands that cannot finish without a terminal, such as creating a new profile with --yes, no longer end with a success message.

Upgrade

lf upgrade          # from 0.4.0 on

From 0.3.0: uv tool upgrade langfuse-agent-cli or pipx upgrade langfuse-agent-cli, then lf setup.