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

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

Total release size: 57.4 MB

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

Download URL logfire_cli-0.1.16-py3-none-win_arm64.whl
Size 3.0 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
04124f461543cffde16bc60c47b96f5197be7a9bfbc70d077b38f539a1f0f7f1
BLAKE2b-256 checksum
How to use checksums
a7ebb63470a3a999cc9d165a72fa66397ea7480494948d8d53ba971200f96584
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.16-py3-none-win_amd64.whl

Download URL logfire_cli-0.1.16-py3-none-win_amd64.whl
Size 3.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
9b28acc1775ae02f2f78b73543409aae8ac5d8f55a468bca48330e66dd772b90
BLAKE2b-256 checksum
How to use checksums
0f91e32d3a82ed3c9d809052b65d63a52974fbca17bbeee313c93ac045b72658
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.16-py3-none-win32.whl

Download URL logfire_cli-0.1.16-py3-none-win32.whl
Size 2.9 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
1fd1868318712dabb3b70c4d9d41decf3284901adb91d6d9e37dc1e59e3cb4a2
BLAKE2b-256 checksum
How to use checksums
ee904534cedfc6437115a709529815c63928c5bfe23a9e87cd4968a909f1b8e7
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.16-py3-none-musllinux_1_2_x86_64.whl

Download URL logfire_cli-0.1.16-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
96ca3b6ee252a0e666e9cfb6748cf722de515148d74684a579ecdb413a0112cd
BLAKE2b-256 checksum
How to use checksums
bb43fcba901c767bc1e3903237cf8cc2d5f2739901451ee8e7375f865f3dd749
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.16-py3-none-musllinux_1_2_i686.whl

Download URL logfire_cli-0.1.16-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
4217818da0f2a8bc66e5b9be8aa51e169841593a84ea514cfbd323d059699025
BLAKE2b-256 checksum
How to use checksums
e7a18737f21cdf9c163e6fd54be4fb5779eda83d0ba6289f53c8541bec2efdf6
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.16-py3-none-musllinux_1_2_armv7l.whl

Download URL logfire_cli-0.1.16-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
5540cc0dbceb9b38d7b39117c7933f4f2de8169935d23e0339bfe7276c491f66
BLAKE2b-256 checksum
How to use checksums
93872ea275d2c60db822fcd162ae4b42bc1e708e6a422c2138039d7b9a03ae91
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.16-py3-none-musllinux_1_2_aarch64.whl

Download URL logfire_cli-0.1.16-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
e21116345e6c31e236e6ebec878fa5512de099dc5a1300ae77235553b780efb2
BLAKE2b-256 checksum
How to use checksums
e2aa6a4feae704ad294b87101c593b17f8545759ac8ec1d03659fb4fc2b2e09a
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.16-py3-none-manylinux_2_31_riscv64.whl

Download URL logfire_cli-0.1.16-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
881c729feda8df502f5fb191f20563dc3452825fa5ac0d2dddafe5476e9deed3
BLAKE2b-256 checksum
How to use checksums
de927f36cc5dbe09c604c8afdab4d0972bec279dde074d410fe8806033218c5e
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.16-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL logfire_cli-0.1.16-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
bf611206a3ca502cc5c03e4f83c3af85d16659486261edc988edf119182d692c
BLAKE2b-256 checksum
How to use checksums
947ae43979b21bdf83a3fd277a90ad8e7417964ae54b0aae81f3af8cc766dc4f
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.16-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl

Download URL logfire_cli-0.1.16-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
25c870472a8cdcac9649a48f13dd09f5a8b379299a72e2d5e6f0a4e248c3e1fe
BLAKE2b-256 checksum
How to use checksums
fcb5e5dbad4c0c7f0668c08ef7c45cc2e1479d0103effaf51a81812331b0c8ae
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.16-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl

Download URL logfire_cli-0.1.16-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
5b6601094ae7d6512a221fb764dbd406fcaf510d3a23a1ed25b40b19a87fb54d
BLAKE2b-256 checksum
How to use checksums
ba5008ed17920643759be0f520cbf2b2b8f4f5323680256743d4897956e3b676
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.16-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL logfire_cli-0.1.16-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
eee6644582498ecce348631a614714e7e529c1932e9a5687b0de0b863e9e68b4
BLAKE2b-256 checksum
How to use checksums
5e6e0153da9bb05160990700f63a8b4da1a6897a9103b64a507f5d6d7519b0ff
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.16-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL logfire_cli-0.1.16-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
746589be2dd7442b2ca3b46f909c9b4e57f339670cf7dbad871255e0fdc50502
BLAKE2b-256 checksum
How to use checksums
b7e15e368204c3fa5a9af5de1cc880a8e41f5103b886c4e58717ab1406997be6
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.16-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL logfire_cli-0.1.16-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
003689ca8edcaef7f55d57dcaa1c501a5001256488daa123fa2040c4889c2f7a
BLAKE2b-256 checksum
How to use checksums
f6c715b2b211d9acfa2c05d7de1c47d71209ea12a638168a425453801e626a00
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.16-py3-none-macosx_11_0_arm64.whl

Download URL logfire_cli-0.1.16-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
8b7d37360565562b27263db8bf37d7f934ef570c47fa70d45789ad0d6e25d875
BLAKE2b-256 checksum
How to use checksums
a4b97b9972ee5a254eaed333b209a9a55d7a355280242d0e9cc51853b8a70b2e
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.16-py3-none-macosx_10_12_x86_64.whl

Download URL logfire_cli-0.1.16-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
41b2d1e13d0d113d1af0aa45591f428401c1cdd854cbae6f5d56c5b956b9c1ad
BLAKE2b-256 checksum
How to use checksums
46d43ecc663591d110873f722f9af9189d59a909207d9af2ec82611d807173b2
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.16-py3-none-linux_armv6l.whl

Download URL logfire_cli-0.1.16-py3-none-linux_armv6l.whl
Size 3.3 MB
Tags Python 3 linux armv6l
SHA-256 checksum
How to use checksums
e4d275378b8d854ff13badcb16ecd00072cf698159cbd78acbed2db718edcc2d
BLAKE2b-256 checksum
How to use checksums
fe80e5e45d78a9fb10ea0278b739b76a93c69ffe33b20e7b355ca084ad7dfb3b
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.16

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