See the main CONTRIBUTING.md to learn how to contribute to Langfuse and its integrations.
The hook is a single uv script with inline dependency metadata, and Claude Code
runs hooks/langfuse_hook.py directly. There is no build step and no package to
install.
Run the tests:
uv run --group dev pytestLint with the same rules as CI:
uvx ruff check --select F,E9 .CI also starts the hook once with an empty payload, which catches a broken script header before it reaches a user:
echo '{}' | uv run --script hooks/langfuse_hook.pyTests run against Python 3.10 and 3.13 in CI. Add --python 3.10 to uv run to
reproduce the older matrix entry.
To try your checkout as a real plugin, register the repository itself as a marketplace instead of the GitHub one:
claude plugin marketplace add /path/to/Claude-Observability-Plugin
claude plugin install langfuse-observability@langfuse-observabilityRestart Claude Code afterwards, so that it loads the hook. Run
claude plugin marketplace remove langfuse-observability when you are done, and
add the GitHub marketplace again to go back to the released plugin.
-
From a clean, up-to-date
mainbranch, raiseversionin.claude-plugin/plugin.jsonand commit that change. -
Tag the release commit and push both:
git tag v1.2.3 git push origin main --follow-tags
The release workflow refuses a tag that does not match the manifest version. It then runs the tests and the hook smoke check, and creates a draft GitHub release with generated notes.
-
Review the draft release, give the notes a human pass, and publish it.
Installed plugins do not update themselves, so users reach the new version only
after claude plugin marketplace update and claude plugin update.