Repository navigation
lf 0.4.0
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 installslfwith uv or pipx (installing uv first when you have neither) and runslf 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 upgradeupgradeslfwith the tool that installed it, then installs the matching skill.lf uninstallremoves the skill, the saved profiles andlfitself;--dry-runshows the list first, and it judges the skill removal by what is left on disk.lf setupis safe to run again: it keeps working credentials, skips a skill that is already installed for this version, takes--profile-namefor a second Langfuse instance (the new profile becomes the current one), and ends with questions to try.lf doctorshows wherelfis installed, whether a newer version is on PyPI (or why it could not check), and whether the installed skill matches yourlfversion.
Also
lf metricsrejects 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
lfprompt 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 onFrom 0.3.0: uv tool upgrade langfuse-agent-cli or pipx upgrade langfuse-agent-cli, then lf setup.