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

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

Total release size: 57.0 MB

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

Download URL logfire_cli-0.1.15-py3-none-win_arm64.whl
Size 3.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
85bec6d23e4492f44c43df0deb6d78124690a9f56391539085d7d2fbe72b402b
BLAKE2b-256 checksum
How to use checksums
09de1ac23e3061c0e6562528db275eaefb5b897594c0d87f0a8ddb24c78a9c02
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.15-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.15-py3-none-win_amd64.whl
Size 3.1 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
7a96c482fd39f77fdde8367fca56bde679cbed511db630dc6bf38225f8ed2364
BLAKE2b-256 checksum
How to use checksums
1f366ccc66c4166b786f03f655b5b878d40f540826ccb63c649a19fb3e3c4546
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.15-py3-none-win32.whl

Download URL logfire_cli-0.1.15-py3-none-win32.whl
Size 2.9 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
2e1093bffb2a1fa34c4191a3b3c6fd526006da19bd3d1b4acc8396c4325c7a48
BLAKE2b-256 checksum
How to use checksums
75434aed582dc2ae796a0e71e20e659db24eec3c2223c7595083b0195ea5819a
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.15-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.15-py3-none-musllinux_1_2_x86_64.whl
Size 3.7 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
f819afcb8eaf1c81f186f74dcf12325c1a3972000bb39a2dba05e4c0388ee8b8
BLAKE2b-256 checksum
How to use checksums
f09edad814eeaac5070ff015bd342cfff9d7a9288d6e7c18788377c533f7194b
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.15-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.15-py3-none-musllinux_1_2_i686.whl
Size 3.4 MB
Tags Linux musl 1.2+ x86-32 Python 3
SHA-256 checksum
How to use checksums
dc2be364fef411eab7a0311fc6fec3369b429bb30fa57203a9e5a4a6fa67bb38
BLAKE2b-256 checksum
How to use checksums
727f2ea0693b7818a8f0d06ac57299d5a99aa53a1da44f13e792b99ecd1f2a97
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.15-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.15-py3-none-musllinux_1_2_armv7l.whl
Size 3.3 MB
Tags Linux musl 1.2+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
7b83d64d5dca3fc591ed089c298fe781a809ab67632f1ba9e513a83e2c00bc01
BLAKE2b-256 checksum
How to use checksums
8e39703bf7eddb0949a8220e6b11804be3309ab807a2aa982909b8beb763530e
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.15-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.15-py3-none-musllinux_1_2_aarch64.whl
Size 3.5 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
221c19a92c4059decb89661ffb236a12870e77e1119f18a60375cac43fba0233
BLAKE2b-256 checksum
How to use checksums
4e34f0321e5421c783e61d3ec523d1e57b4796bcdca743bbeaff246b6eb539c8
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.15-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_31_riscv64.whl
Size 3.4 MB
Tags Linux glibc 2.31+ RISC-V 64 Python 3
SHA-256 checksum
How to use checksums
91b60ccc7c4e8e42925b48b1ba96d7d588dbb849ae70d12bc0b7ae94e165d768
BLAKE2b-256 checksum
How to use checksums
a7f35ed497637dc979b62679ca04b5f2906fb706cb684af5729831314c9c6439
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.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 3.6 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
c3d426c4c0a9732b457c29621372aa93131be2d4840b4f19fda90ef25c5c75ac
BLAKE2b-256 checksum
How to use checksums
cde0a2e5b38b37f73a558feb08617932139ed9767a9bc7821bfd16ec81ccf42e
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.15-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl
Size 3.4 MB
Tags Linux glibc 2.17+ IBM System/390x Python 3
SHA-256 checksum
How to use checksums
eaeb55e0147eb89bfb425a2d1bd26c59821ec46f02bb15c6254d48187188fb64
BLAKE2b-256 checksum
How to use checksums
43f3d4c29805a3f9ad3dcde775c71a5cc76a1b36d6238eaee2b56cae5908d8d9
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.15-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
Size 3.7 MB
Tags Linux glibc 2.17+ PowerPC 64-le Python 3
SHA-256 checksum
How to use checksums
baaddef133bb5ef0649d397a12675d63317f2568ea34becd0ec0621d9fee67c1
BLAKE2b-256 checksum
How to use checksums
d0d6c5e56e1e9416c92deae0da9919b3e4e25835cdf09802e052d1443553f173
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.15-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 3.6 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
719e97d3e65707dbf839049f982bbccb140b267ff0443a24d287eb8401602ed9
BLAKE2b-256 checksum
How to use checksums
7ce2f856fc787b9c2d942b15a9c6f07b07f05aebbfaaea171be1d6334ba624a7
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.15-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Size 3.3 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
1b7036944105cc8e7dd7b6f8707d23d1329ead28c3d2ab16ecd2e0d49a55b18d
BLAKE2b-256 checksum
How to use checksums
84d8d367b45fcf6668010df19ea55746af70435e36aec6b0ca1b4ae53f8bf43c
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.15-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.15-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 3.5 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
61c20163b0d29a7a4f38c045f135651ecbc4d5657aab6dde82f789fb5aa08a58
BLAKE2b-256 checksum
How to use checksums
9aa727f3b281659aa64e454a6e79290e5e3f1343b06fd57f26d1fdde12477f52
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.15-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.15-py3-none-macosx_11_0_arm64.whl
Size 3.0 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
12f15dc9c82efbedfdc6d8e60452a7326bb86cf6307804902c77417166f358bc
BLAKE2b-256 checksum
How to use checksums
c433d4dbcc0b6dd1dcfbc50c524fcf64fabb38d49689422dcf8e951e6aacd092
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.15-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.15-py3-none-macosx_10_12_x86_64.whl
Size 3.2 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
ddc9abbde69a376bb8ab7f71cbc2b0f7de03b328b7f265e7f11e73633c46343d
BLAKE2b-256 checksum
How to use checksums
19f046488528af9d67f9728928ab6411f0386447571eac13e46e12022bca5945
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.15-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.15-py3-none-linux_armv6l.whl
Size 3.3 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
fcb7aa850d9eb347d4b67171a6c98b9591c7e8f27ce4375df2f4e7679e6b91bf
BLAKE2b-256 checksum
How to use checksums
8b3b5bde956036292b7dbd4e89f1696b034588addfff2a5c30194d494bc1a953
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.15

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