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

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

Total release size: 58.7 MB

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

Download URL logfire_cli-0.1.19-py3-none-win_arm64.whl
Size 3.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
125ac6bce08efd405741ecf93cb397cb46ac6bfb1e5f865ac972d39f2138c3a3
BLAKE2b-256 checksum
How to use checksums
ba3a0c719ff60d80ac61d74e9c306d3031a106b01a8935090204996556b83399
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.19-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.19-py3-none-win_amd64.whl
Size 3.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
08a56c200b2250a41cabca95ebf0b0d12727361471949c387536bb2a0d5aac95
BLAKE2b-256 checksum
How to use checksums
66088c776266fcc55fe9166cad36fe3d61c34d940a50a84ea9ab5746c528f504
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.19-py3-none-win32.whl

Download URL logfire_cli-0.1.19-py3-none-win32.whl
Size 3.0 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
788d520e038c64d5d5bbf64abd5c3d5612369e0a57091ae986f3cdb97ff656d4
BLAKE2b-256 checksum
How to use checksums
1545d13a0e2e8242f86f001a7745be7303eb1f3fe01d4286d90936895506d1d5
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.19-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.19-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
0b4ff84019dcfd72f613a46b5709c67d083ca04b5c521a23cd8676c6780360a9
BLAKE2b-256 checksum
How to use checksums
e67d472292800a7bfa57dacda913f45f9e40e9f415be10fe94df128677ba9a96
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.19-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.19-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
c69f1f76cdb847519501a1e8a3c87a0baf7475af83676a574d83aa09fd6cee6d
BLAKE2b-256 checksum
How to use checksums
df44e829fe24e23f22d0ed8a5724401593692bcbd3e0dc65af920b7138bec8b0
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.19-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.19-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
22d829106b61c1e794e5ffd6f164aef126e978b7a6503c924bd2d6254d69dfc6
BLAKE2b-256 checksum
How to use checksums
7e1a98799398c297d20b882b77a319280c7011caf3081aed7f4b6eb0a94e393c
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.19-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.19-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
ad04d65d0ea194780d5af2a423c0fdf9dcdb36e90be32747698dfdcd74329704
BLAKE2b-256 checksum
How to use checksums
efa5ee23aee06edc51097bb843fcd0f784c71e900764ded0741141a4d36b0e27
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.19-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.19-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
42655150a193762b4a7af6425abe4a35a90d6f6467c7b4a64ae716ef9f971a6d
BLAKE2b-256 checksum
How to use checksums
3d3da1b6fbb8e4b4af49fa6ffab7ca61373f0a3d59cd4c571d7e8a8c07208fb5
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.19-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.19-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
d760e2d26dddbdd0ad104e9b334e786f0e15b062fc80d20b3d94e61376e2eb5a
BLAKE2b-256 checksum
How to use checksums
d80ad5c19a1036ef703e6c53ac2a869cc88bc44c249d579a033e347a87a89cf9
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.19-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.19-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
c6ece725915551875535e63303b01194bafae33a464335da042f0403a858bf2b
BLAKE2b-256 checksum
How to use checksums
a3950f858084a7355ef3298e8ee22167d4c4121d33428aea23dcd239e9f9e55e
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.19-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.19-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
b3ea9286299de6838088dcf1b8669866935cd815411add3bf63fe1ba27ed7adf
BLAKE2b-256 checksum
How to use checksums
cd4e8eca3d736c3842ccb57611cbb4d9e8ee7a80bd06d0cdf47f90b85a0bb834
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.19-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.19-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
7551f0b328165a6da079ba8552dcfb541711f71e43752b1df2cf52861547f1c0
BLAKE2b-256 checksum
How to use checksums
3df713082bf413d8acdf3607efef3230826489e0fb40f95ffb656d47f7d77756
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.19-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.19-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
c7b3f9ff598719769fa2b212d8905f30afa6c9d0d6ccb53f6bfa1b750cfe7b79
BLAKE2b-256 checksum
How to use checksums
ab1410363889bb88672982200c6717a12d3ac3b854e82f5e9d55673ed9cb783b
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.19-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.19-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
484d3d8f8b103fcdbb82aa3bb351a8cdcba976c67eaacf3e8868a5aa5ce50644
BLAKE2b-256 checksum
How to use checksums
2a06afed2f5c7d71b6680afcb5b2ff7de8895165c1242faad568cd7530484fdd
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.19-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.19-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
84d82c8206a31463133beb73d8e927495ee8aa321427c670e2b08c2ddd3744e9
BLAKE2b-256 checksum
How to use checksums
c8b13c7b46cd3ed3b97a44104bdf7a9e86c9ee45ae7ff40242bad55dae21b0f4
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.19-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.19-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
69fab7cfd3f0241c2135ea587b174a0f886ba3893db6ab9d6e435724ed4cae47
BLAKE2b-256 checksum
How to use checksums
830d2b116710450208614cea4834244cdd6c3ae80eee51f48a03a2610e26da45
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.19-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.19-py3-none-linux_armv6l.whl
Size 3.4 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
e49918c9cec9805641b0992a051515d4ff8a36598df3acbb4c90066481a61f39
BLAKE2b-256 checksum
How to use checksums
b3c2a837c8ff36f21c88aa61857579ac22a0ba69f756b2a801ded7b8aa1632f1
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.19

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