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

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

Total release size: 57.5 MB

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

Download URL logfire_cli-0.1.17-py3-none-win_arm64.whl
Size 3.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
2d50651e8a7bfa1e155a9fc814aba79e2dab007befcd9de1a272fb8b3ae87284
BLAKE2b-256 checksum
How to use checksums
d2566381ceaf1873ae5b26c95d94594ff32448184a9896a6862a771f8dd24ceb
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.17-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.17-py3-none-win_amd64.whl
Size 3.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
951961c1e01cbb7b8d5043ca8260d70147309e468c465533c38d5b9cee6217b0
BLAKE2b-256 checksum
How to use checksums
54ba0c906569d8f170c3ec5632e3f4e50ebeac5153367a205ea7a6e6618dc333
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.17-py3-none-win32.whl

Download URL logfire_cli-0.1.17-py3-none-win32.whl
Size 2.9 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
230b016a0f8d4753ac3f355d6dd992e815f1ce61a3f087d691249beea97e8392
BLAKE2b-256 checksum
How to use checksums
500f74fe319886236fb7961e3a51201c9a7a75e9b8fddbe1505348d71700680f
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.17-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.17-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
5b8036880d12a810ca951a56249acf68c64111334c8db70cd5b162e25c456f9d
BLAKE2b-256 checksum
How to use checksums
b88a66b9cdadca4db5245d469106e5e3f2ff87cad2e23f6172727220e41e8835
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.17-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.17-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
0c60ba94c1e8c9c910f9977e84c6d0b8dece64e1c03162fc1228814c1dc64a1d
BLAKE2b-256 checksum
How to use checksums
4409a0d7b472fd637d23924dd239b51f45a2c8ac06f993b9b6e321367da48b94
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.17-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.17-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
340b23cc181ce4983e412b3c496041195246065683770d9bae1b97194cc2d171
BLAKE2b-256 checksum
How to use checksums
ff708e7009e05991ee81854fc7a99899846bea85dc40953bc073db99b88e5736
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.17-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.17-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
ef8eb2926b377d22c20a7ac3e3b80cee54de90187f9cc12b3ca4e73f9d3991f9
BLAKE2b-256 checksum
How to use checksums
903011c23ee72201997e5f18f5aa80cc94eaa839b35d3e9b50ab89f77d6484ee
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.17-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.17-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
1083354f3e7d21add2a82972e5186942a44c1e8c7270e838df6e5b632f4e35b7
BLAKE2b-256 checksum
How to use checksums
67142f313d45617662ed3a3c30b115fc592ca0d3e529af35164e635864750b29
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.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.17-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 3.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
26c627cdf97453ba4fa5446c4364d155063ad709cd9ae689476cf80ddc16bebb
BLAKE2b-256 checksum
How to use checksums
7b07387778b525b8a6d712471662d2d287796a4281d364550defa124b21205ce
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.17-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.17-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
f87f0439a65550527a7d78fffe410eaa61cad17832d892611684054ea4119ef5
BLAKE2b-256 checksum
How to use checksums
54eb462e7e8e4e57647c57b891c8b600d7f21ddeee891a292c5e51f434a7a0b2
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.17-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.17-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
b1e9e21b9ddd782e2a414259d61d75ea19606903f5aab681f12bccc267569009
BLAKE2b-256 checksum
How to use checksums
6a9bc70ebf40e5192c42456e22b402d4e99574ee00eec84219d8faf1204233a7
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.17-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.17-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
da12c8e14bbe9d718ec78610b2efff2063f6d9280e64bc030218fc66ca2e9f28
BLAKE2b-256 checksum
How to use checksums
7606db4a683eb3c3a539910d4d3278c6f2099b00e90524a43020d1dda6ee63dc
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.17-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.17-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
4644d90c50e3537f4a8d275d3631876984e0285c771435f789f6e785445a91b7
BLAKE2b-256 checksum
How to use checksums
b79a4e75c9ec0d939ccd69a5b689aff2633a17ee918c292806153657e00157a8
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.17-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.17-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
6e71b1e3d3a7d41611591c3cced28a29b4327ba6177e84e391ee3eb934f36445
BLAKE2b-256 checksum
How to use checksums
69599d901df78dce84395418c7e2dc3b322fc88ed8a2ffb3749fe3ebcea61147
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.17-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.17-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
8d703308e486c50db41f7a86575d2b3a73a313cec0b385fd06707063bd750a3e
BLAKE2b-256 checksum
How to use checksums
c7bfa0e9385422dc9b1972de5c996c10ababb190949f4eb2c78c6f930aef1217
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.17-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.17-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
b4a8fc419a1a029a8fd9e5e8fd98ec45f4a7412fa0f025d8a4d1d53802151c86
BLAKE2b-256 checksum
How to use checksums
7e582787eeb23f77e173f3fb1142a7bd76f7fcf7d861f33a1af41d425c6c0af3
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.17-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.17-py3-none-linux_armv6l.whl
Size 3.3 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
1b82d7a2f1627a6143ed8125921c70dd9c7e26b37fc36040529f6de84ceca8f8
BLAKE2b-256 checksum
How to use checksums
ecb033681885533af74d156a83a98136c7b4b478ca13f871068833361c0194b2
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.17

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