Skip to main content

Logfire CLI

The Rust command-line interface for Pydantic Logfire. Sign in, query your traces and logs, manage projects and tokens, and connect your coding agent to Logfire from the terminal.

This package installs the native CLI, not the Python instrumentation SDK. Install an application SDK separately to send telemetry; see the Logfire documentation.

Install

Try it with uv:

uvx logfire-cli --help

Install it as an isolated command-line tool:

uv tool install logfire-cli
logfire-cli --help

Or use pipx install logfire-cli. In an activated virtual environment, you can also run python -m pip install logfire-cli.

This standalone package owns only logfire-cli. In Logfire 6, the Python logfire package owns logfire and installs the same native CLI alongside the Python SDK, without either wheel claiming the other's command. If an older logfire-cli installation provided logfire, use logfire-cli after upgrading the standalone package.

Python 3.9 or newer is required for the launcher. Wheels include the matching prebuilt binary for macOS (ARM64 and x86-64), Windows (ARM64, x86, and x86-64), GNU/Linux (ARM64, ARMv7, x86, x86-64, PowerPC 64 LE, RISC-V 64, and IBM Z), and musl Linux (ARM64, ARMv6, ARMv7, x86, and x86-64). You do not need Rust installed. GNU/Linux requires glibc 2.17 or newer, except RISC-V 64, which requires glibc 2.31. The musl wheels support compatible Alpine Linux versions.

New to Logfire

From your application's directory, create an account, organization, and first project in one guided flow:

logfire-cli --region us signup --org acme --project my-app
logfire-cli --org acme project current

Replace acme and my-app with the real names you want. Use --region eu for the EU region. Browser OAuth credentials go to the operating system credential store; the project SDK credential stays under .logfire/ in your application.

Then add instrumentation with an installed coding agent:

logfire-cli --org acme wizard

Use an existing account

Use your real organization name in place of acme, and eu instead of us if your data is in the EU region:

logfire-cli --region us --org acme auth
logfire-cli --org acme mcp projects

Complete sign-in and approve access in your browser. OAuth credentials are stored in the OS credential store, scoped to the Logfire origin and organization.

Choose a project from the list, then query its data through the hosted Model Context Protocol (MCP) server:

logfire-cli --org acme mcp query run 'SELECT message FROM records LIMIT 20' --project my-app

For scripts, make the target explicit and request non-interactive JSON output:

logfire-cli --org acme --no-input --output json mcp projects

Connect a local project

From your application's directory, create or choose a project interactively:

logfire-cli --org acme init

To connect an exact existing project without a picker:

logfire-cli --org acme init use --name my-app --permission send
logfire-cli project current

OAuth remains in OS-protected storage; the SDK token stays with the local project. Keep credential files out of version control.

To create additional read or write tokens for that project:

logfire-cli --org acme token read
logfire-cli --org acme token write

Each command creates a new token and prints the secret once to standard output. Store it securely; do not paste it into logs, issues, or chat. These commands do not replace the project's saved SDK write token.

Run Python with automatic instrumentation

The CLI selects the active project interpreter and delegates instrumentation to the Logfire Python SDK installed in that environment:

logfire-cli run app.py
logfire-cli run -m uvicorn main:app
logfire-cli run pytest tests/

Use --python .venv/bin/python when interpreter discovery is ambiguous. Run logfire-cli help run for selection rules and passthrough behavior.

Set up instrumentation with a coding agent

With a supported coding agent installed, run this from your application's directory:

logfire-cli --region us --org acme wizard

The CLI detects installed agents and hands off the Logfire setup instructions bundled with this release. The agent can change your project to add instrumentation, using its normal permission and approval controls. It receives the selected target and project identity, but it does not inherit the CLI's LOGFIRE_API_KEY, LOGFIRE_TOKEN, or LOGFIRE_MCP_TOKEN.

If you already know the exact project and setup task, pass them explicitly:

logfire-cli --region us --org acme wizard --project api --task instrumentation

Use bare wizard when you want the CLI and agent to discover the task from the current directory.

To inspect the instructions without launching an agent:

logfire-cli --region us --org acme wizard --print-prompt

Help and updates

logfire-cli help
logfire-cli help mcp
logfire-cli help wizard
uv tool upgrade logfire-cli

Use the upgrade command for a uv tool install installation; otherwise upgrade with the package manager you used to install it.

See the Logfire documentation for application instrumentation and platform guides. Logfire CLI is licensed under the MIT license.

Metadata

Release files for logfire-cli 0.1.18

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for logfire-cli 0.1.18
File Actions
logfire_cli-0.1.18-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for logfire_cli-0.1.18-py3-none-win_arm64.whl
logfire_cli-0.1.18-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for logfire_cli-0.1.18-py3-none-win_amd64.whl
logfire_cli-0.1.18-py3-none-win32.whl Python 3 none Windows x86-32 Details for logfire_cli-0.1.18-py3-none-win32.whl
logfire_cli-0.1.18-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for logfire_cli-0.1.18-py3-none-musllinux_1_2_x86_64.whl
logfire_cli-0.1.18-py3-none-musllinux_1_2_i686.whl Python 3 none Linux musl 1.2+ x86-32 Details for logfire_cli-0.1.18-py3-none-musllinux_1_2_i686.whl
logfire_cli-0.1.18-py3-none-musllinux_1_2_armv7l.whl Python 3 none Linux musl 1.2+ ARMv7l Details for logfire_cli-0.1.18-py3-none-musllinux_1_2_armv7l.whl
logfire_cli-0.1.18-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for logfire_cli-0.1.18-py3-none-musllinux_1_2_aarch64.whl
logfire_cli-0.1.18-py3-none-manylinux_2_31_riscv64.whl Python 3 none Linux glibc 2.31+ RISC-V 64 Details for logfire_cli-0.1.18-py3-none-manylinux_2_31_riscv64.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl Python 3 none Linux glibc 2.17+ IBM System/390x Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl Python 3 none Linux glibc 2.17+ PowerPC 64-le Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
logfire_cli-0.1.18-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for logfire_cli-0.1.18-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
logfire_cli-0.1.18-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for logfire_cli-0.1.18-py3-none-macosx_11_0_arm64.whl
logfire_cli-0.1.18-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for logfire_cli-0.1.18-py3-none-macosx_10_12_x86_64.whl
logfire_cli-0.1.18-py3-none-linux_armv6l.whl Python 3 none linux armv6l Details for logfire_cli-0.1.18-py3-none-linux_armv6l.whl

Total release size: 58.7 MB

Release files / logfire_cli-0.1.18-py3-none-win_arm64.whl

Download URL logfire_cli-0.1.18-py3-none-win_arm64.whl
Size 3.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
e8578617012160929c36c826f106c956d460b2439393c4847d933f2c97656e9e
BLAKE2b-256 checksum
How to use checksums
9665894cf3e3ccd68609a0ea3a8403bf988fd25914ffaef6e5c0bd2b11a50c02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.18-py3-none-win_amd64.whl
Size 3.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
dc48c0d1ad91632fbf783c433a430b42d70d7a7d55616a962297a24313e378b7
BLAKE2b-256 checksum
How to use checksums
c2706038c9b4c318abfd357d89b8673b28ea7f1a68e915950515faca2a3b21df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-win32.whl

Download URL logfire_cli-0.1.18-py3-none-win32.whl
Size 3.0 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
69ccaf457724dda6ed776204e54afbef74b3076fd11f8eae016a1793a7a98cbc
BLAKE2b-256 checksum
How to use checksums
1057be94332d6fef75c116667b117090c85b8097b55df681f0649d2731e584bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.18-py3-none-musllinux_1_2_x86_64.whl
Size 3.8 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
54dc726d972c572ffe3e02418372a00f8f9d697e1017574bf85eefaa591e90a1
BLAKE2b-256 checksum
How to use checksums
f14bdd0a4cdb3624a613c29a683aa6167eb2d4076845349223efc763690d989b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.18-py3-none-musllinux_1_2_i686.whl
Size 3.5 MB
Tags Linux musl 1.2+ x86-32 Python 3
SHA-256 checksum
How to use checksums
3f211d2ebde6beca2700b562416f4563abcae33f5db9ec7f6f01d611542354bc
BLAKE2b-256 checksum
How to use checksums
707f1dd7435d132e4e983d34f7bc84a7bce0dedc4e9ebaf70d544c02c115c1d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.18-py3-none-musllinux_1_2_armv7l.whl
Size 3.4 MB
Tags Linux musl 1.2+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
b452a4fcb8ab188435056998dda52caf7cc34af78be5eb1ed05ff18073051c14
BLAKE2b-256 checksum
How to use checksums
9a5a15f39dc3ae3ae333e5912cc9a44e82b087d10393a5a3db43e4786ddda355
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.18-py3-none-musllinux_1_2_aarch64.whl
Size 3.6 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
46372e0f490756e32001856e4058a7067eac65cf7ccf2591db7a261d2e089de5
BLAKE2b-256 checksum
How to use checksums
ab9e7706fba86da309fc74f7dce5b95e7fb9006d2d60c969a2210f952d545267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_31_riscv64.whl
Size 3.5 MB
Tags Linux glibc 2.31+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
528386091b6305e153a6043ba1be0a96f262eccfb268735b850281bf5d114925
BLAKE2b-256 checksum
How to use checksums
bf950424637c08bdf2986842db08739ab5c9642423afd33a8400154e7973ee1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 3.8 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
d118520125dc591d5eb1b405d210a3774e2b937bc095d1500cf59c3a32f4a0ea
BLAKE2b-256 checksum
How to use checksums
a96c0ba077a00c443958d2e50005c0178fa9eaaa05b7e2f17a414f449155b96f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Size 3.5 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
d2460d4e7e113deb925bc0e5b1dc0e101c27650c3c0398e9fc69f7c3a04a1ddc
BLAKE2b-256 checksum
How to use checksums
8dc7aa6b45a576e61b1d36a94724b5d60310ecf0910d3d82ecde397257659739
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Size 3.8 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
73e5e4c296c6e24a4c2bb86b83da2957c6229861ec5da3d101ef86407331b1a5
BLAKE2b-256 checksum
How to use checksums
6cc705370b140c920171280fc8bcd19937e93cc5980297e9fdf6d9ffcf8800b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 3.7 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
686fbfc520177666582ab37dae1db58a46f2da34fc28ccff11031612ca935a0f
BLAKE2b-256 checksum
How to use checksums
7ddf5130174453d289c32917c3d11420b9e2bd317fb9d34106012a762fa7325e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Size 3.4 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
2845cb2f432e80f2375ce18371190c1673a7d5f9b3d2ee99b95b599185897e0a
BLAKE2b-256 checksum
How to use checksums
cd2a555f65210c081d4685eaa5aa28d1e591c5e4b5bfdfcdb6896552bb799bf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.18-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 3.6 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
b2836b06e7b919a5af8130c485c9706e8153d0622bd26d9038489935d83fb8b3
BLAKE2b-256 checksum
How to use checksums
f658dbd0a76cb0e1bafa943e7f4653c59ea80b87ce799f98ade2c11febb94f13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.18-py3-none-macosx_11_0_arm64.whl
Size 3.1 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
2807b852f5c0503be3de0923aeb4978a31d05c7517cd482c62a26364bd0c5caf
BLAKE2b-256 checksum
How to use checksums
030dca69020188d22a21d41e3de844c05268bccef0696c7b5a6785c7e5d9a67d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.18-py3-none-macosx_10_12_x86_64.whl
Size 3.3 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
c9f9a07a847d3523e1662cd17c0a61fe7db733506b6794f3ed43ee1a6d53b6a3
BLAKE2b-256 checksum
How to use checksums
31a7701ac6fc178aa604d9b3dd65b7758dc369fa6eefcdd5e2af9aa35376f231
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / logfire_cli-0.1.18-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.18-py3-none-linux_armv6l.whl
Size 3.4 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
8c0592ac736b009e2307d68c4a507ce736dc9ea7ab3644a5cc295e690d7ffde6
BLAKE2b-256 checksum
How to use checksums
641b8911b9b1dd4abd507ce60af514f33db65aa8b482f4b06b6df5e3200a0872
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Security for logfire-cli 0.1.18

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page