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
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.20

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.20
File Actions
logfire_cli-0.1.20-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for logfire_cli-0.1.20-py3-none-win_arm64.whl
logfire_cli-0.1.20-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for logfire_cli-0.1.20-py3-none-win_amd64.whl
logfire_cli-0.1.20-py3-none-win32.whl Python 3 none Windows x86-32 Details for logfire_cli-0.1.20-py3-none-win32.whl
logfire_cli-0.1.20-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for logfire_cli-0.1.20-py3-none-musllinux_1_2_x86_64.whl
logfire_cli-0.1.20-py3-none-musllinux_1_2_i686.whl Python 3 none Linux musl 1.2+ x86-32 Details for logfire_cli-0.1.20-py3-none-musllinux_1_2_i686.whl
logfire_cli-0.1.20-py3-none-musllinux_1_2_armv7l.whl Python 3 none Linux musl 1.2+ ARMv7l Details for logfire_cli-0.1.20-py3-none-musllinux_1_2_armv7l.whl
logfire_cli-0.1.20-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for logfire_cli-0.1.20-py3-none-musllinux_1_2_aarch64.whl
logfire_cli-0.1.20-py3-none-manylinux_2_31_riscv64.whl Python 3 none Linux glibc 2.31+ RISC-V 64 Details for logfire_cli-0.1.20-py3-none-manylinux_2_31_riscv64.whl
logfire_cli-0.1.20-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.20-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
logfire_cli-0.1.20-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.20-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
logfire_cli-0.1.20-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.20-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
logfire_cli-0.1.20-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details for logfire_cli-0.1.20-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
logfire_cli-0.1.20-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details for logfire_cli-0.1.20-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
logfire_cli-0.1.20-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for logfire_cli-0.1.20-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
logfire_cli-0.1.20-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for logfire_cli-0.1.20-py3-none-macosx_11_0_arm64.whl
logfire_cli-0.1.20-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for logfire_cli-0.1.20-py3-none-macosx_10_12_x86_64.whl
logfire_cli-0.1.20-py3-none-linux_armv6l.whl Python 3 none linux armv6l Details for logfire_cli-0.1.20-py3-none-linux_armv6l.whl

Total release size: 59.9 MB

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

Download URL logfire_cli-0.1.20-py3-none-win_arm64.whl
Size 3.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
76cfe225c27ead2e97178a68ac23ddb4ec1b7b731b90649f8f2e2d80f0a6c8da
BLAKE2b-256 checksum
How to use checksums
ab8a8b8b444a86996a14994894e08cba46ef11dd55c87b9dadf870bfb1446407
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.20-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.20-py3-none-win_amd64.whl
Size 3.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
d5b3e5bc8d7efe5d3fe3543b763ce4fbf8515f825390126319dbb6cd08dfff4c
BLAKE2b-256 checksum
How to use checksums
31a5fc4daf4d08a0a988db3cbc09ea917d88f3472388f3456a5e1f944903c568
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.20-py3-none-win32.whl

Download URL logfire_cli-0.1.20-py3-none-win32.whl
Size 3.1 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
ab3c7eb83d7a067d96083e87659848e2dd27f1b7bf3ad103310d057cec29e8bf
BLAKE2b-256 checksum
How to use checksums
e07ca3b9811a15238b090bfa24135b47790a5e1ae610fd16cf6f47da01faefe7
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.20-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.20-py3-none-musllinux_1_2_x86_64.whl
Size 3.9 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
54b645c9556f094eb73bc84c8e0621ea6f676723c98fdf64273f7ccfe3218030
BLAKE2b-256 checksum
How to use checksums
95f5f1a134403eafe00895476f270466b3d06352d77c03b87058071717e0eccb
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.20-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.20-py3-none-musllinux_1_2_i686.whl
Size 3.6 MB
Tags Linux musl 1.2+ x86-32 Python 3
SHA-256 checksum
How to use checksums
faef1fd273f7ccca63c58655401843bb3e63d7ec0eb7d5f411d0f7534f61d71d
BLAKE2b-256 checksum
How to use checksums
c7562de72affd4859558ca42c40504dd8924c4213fca325aa22ad783f99747a3
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.20-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.20-py3-none-musllinux_1_2_armv7l.whl
Size 3.5 MB
Tags Linux musl 1.2+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
a7847c989ffc5f98d7b47b059fe196b34b2048e79c54ba074f6891d8dc1de260
BLAKE2b-256 checksum
How to use checksums
f02041fd20183c08791a4c9f8b262f7e2cf3d1c017408dee638bb37b19c289d7
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.20-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.20-py3-none-musllinux_1_2_aarch64.whl
Size 3.7 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
500c17016675e275a160c2e15992132a3e4a1305507dcf70e172c944cc004689
BLAKE2b-256 checksum
How to use checksums
39293053975c2c9df0498c9fe7d6af9ef6dec496970a54762d04af2ed97c219c
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.20-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.20-py3-none-manylinux_2_31_riscv64.whl
Size 3.6 MB
Tags Linux glibc 2.31+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
17479cc59d59ab9507596a44f0d82602837264c27e062624b20b9d7ebd69284d
BLAKE2b-256 checksum
How to use checksums
7c50ead5d8518335cd7e09f5e1151657b54436104a38d19c4c334d60102e6852
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.20-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.20-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
b766ba6f6db4b404022a34d0d836d81aba2559a4fb43814cd51e84c39b893115
BLAKE2b-256 checksum
How to use checksums
92f83c200c36ce36e5b126f2ac440ca67aa31a0aa58cbbb52a84825c8792d0b5
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.20-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.20-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Size 3.6 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
48aa9716565de02cf9c84f0c1fc725e2e4f3b6275674d1cabd61e2bf66043fc9
BLAKE2b-256 checksum
How to use checksums
10b40c51ef341c5b7cef124d029a1ef66e97ceb31601953a449c38eee324e1c3
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.20-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.20-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
a066eec4c6f9d953f88de1a684b3082f1d3da1df2545790b518d9b49acc64e63
BLAKE2b-256 checksum
How to use checksums
573f4c87ebabd285bea5eb9148f38eb7ab01a12dac4b10d709925906ed777acc
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.20-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.20-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 3.8 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
8cf7a354028016649e21742d7c8cda625bf8b574726702dba31467332550cf76
BLAKE2b-256 checksum
How to use checksums
ee24f5445ad2c017d328872ce6381f736020d4176c5ef75217eee28c1d1de570
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.20-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.20-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
1efdf25006f2c0c419ca1dd654fa832f1e85f97cf95e8f30ffa3f65a50f4926f
BLAKE2b-256 checksum
How to use checksums
90f5a47ef2e3a8cd22d35ef2f7dbd9436e73183862eaa75b67990b66e363cad8
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.20-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.20-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 3.7 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0c5b60ea18fcb2c08cb76fe1f61c6a072281c18c1ddb802fd8398ac7b9ebb936
BLAKE2b-256 checksum
How to use checksums
1eb189a8f5dc0f3f657ec9718059b16090b169c5c03bfe60119387674b3241d6
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.20-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.20-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
59406700b7e528ea2aa46e5a1bc307558b60060649ffd2c093e05b91a55984a7
BLAKE2b-256 checksum
How to use checksums
94917f50754046af49953750877b7e2fb06fa6570619261f0719935cc37dda99
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.20-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.20-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
27a9ed4b72ecf9833c9b2b42a3c43e73bf9b06ce3d8c05380d4fb446eea09816
BLAKE2b-256 checksum
How to use checksums
fb7ed6854cac2fe3ea9222b0524d44d1ea2598de87433c8d6b68c99e62ff5d28
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.20-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.20-py3-none-linux_armv6l.whl
Size 3.5 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
1e7cb9b155832a4b572a7cdb97c7c103c2c733e42f77985e695261a637bc12e3
BLAKE2b-256 checksum
How to use checksums
62137d37a5fb76b800619d33a49f9de09e2569c36f66a2bd1c8ae5459d15e9c3
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.20

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