@pydantic/logfire-cli-darwin-x64 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -12
- package/bin/logfire +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,13 +3,15 @@
|
|
|
3
3
|
Rust command-line tools for [Pydantic Logfire](https://pydantic.dev/logfire).
|
|
4
4
|
|
|
5
5
|
`logfire` authenticates against the hosted (or self-hosted) Logfire API, drives
|
|
6
|
-
the public Logfire MCP server,
|
|
7
|
-
Platform API — with first-class machine output
|
|
6
|
+
the public Logfire MCP server, runs bundled agent skills, points a project
|
|
7
|
+
at Logfire, and exposes the typed Platform API — with first-class machine output
|
|
8
|
+
for scripts and coding agents.
|
|
8
9
|
|
|
9
10
|
## Quickstart
|
|
10
11
|
|
|
11
12
|
```bash
|
|
12
13
|
cargo install --path crates/logfire-cli # see docs/installation.md for details
|
|
14
|
+
logfire --region us signup --org acme --project my-project
|
|
13
15
|
logfire auth # browser OAuth into the OS keychain
|
|
14
16
|
logfire mcp tools list # use that session against public MCP
|
|
15
17
|
```
|
|
@@ -19,9 +21,13 @@ logfire mcp tools list # use that session against public MCP
|
|
|
19
21
|
| Command | What it does |
|
|
20
22
|
| --- | --- |
|
|
21
23
|
| [`logfire auth`](docs/authentication.md) | Browser OAuth shared by CLI and MCP |
|
|
24
|
+
| [`logfire signup`](docs/commands/signup.md) | Create an account, first project, and local SDK credentials |
|
|
22
25
|
| [`logfire init`](docs/commands/init.md) | Point a directory at a Logfire project |
|
|
23
|
-
| [`logfire project`](docs/commands/project.md) |
|
|
26
|
+
| [`logfire project`](docs/commands/project.md) | Inspect or clean this directory's SDK project configuration |
|
|
24
27
|
| [`logfire setup`](docs/commands/setup.md) | Hand off repository instrumentation to Codex or Claude Code |
|
|
28
|
+
| [`logfire run`](docs/commands/run.md) | Run Python scripts, modules, and console commands with automatic instrumentation |
|
|
29
|
+
| [`logfire skill`](docs/commands/skill.md) | Discover and run CLI-bundled Logfire agent skills |
|
|
30
|
+
| [`logfire codex`](docs/commands/codex.md) | Send Codex's own completed turns to Logfire |
|
|
25
31
|
| [`logfire token`](docs/commands/token.md) | Mint a project read/write token and print it |
|
|
26
32
|
| [`logfire api-key`](docs/commands/api-key.md) | Mint a project-scoped API key and print it |
|
|
27
33
|
| [`logfire api`](docs/commands/api.md) | Typed Platform API endpoints |
|
|
@@ -36,7 +42,7 @@ Every command and group accepts concise `-h`/`--help`; use
|
|
|
36
42
|
The [**User Guide**](docs/README.md) covers everything in task-oriented pages:
|
|
37
43
|
|
|
38
44
|
- [Installation](docs/installation.md) — the binary and shell completions
|
|
39
|
-
- [Authentication](docs/authentication.md) — logins, regions, `
|
|
45
|
+
- [Authentication](docs/authentication.md) — logins, regions, `LOGFIRE_API_KEY`, and OS-keychain storage
|
|
40
46
|
- [Output contracts](docs/output-contracts.md) — human vs. `--output json`/`jsonl`, the envelope, exit codes, and flag precedence
|
|
41
47
|
|
|
42
48
|
Global options apply before or after every command. `--region us|eu` (env
|
|
@@ -57,26 +63,29 @@ The CLI is a Cargo workspace of small, single-purpose crates:
|
|
|
57
63
|
| `logfire-cli` | The `logfire` binary: argument parsing (clap) and command dispatch. |
|
|
58
64
|
| `logfire-api` | The typed `logfire api` command surface over the generated client. |
|
|
59
65
|
| `logfire-api-client` | Generated from the OpenAPI schemas (see below); never hand-edited. |
|
|
60
|
-
| `logfire-auth` |
|
|
66
|
+
| `logfire-auth` | Terminal UX, organization verification, and profile persistence around browser OAuth. |
|
|
61
67
|
| `logfire-config` | Credential resolution, regions / base-URL, and the request context. |
|
|
62
68
|
| `logfire-init` | `logfire init` project setup and the `.logfire/` credentials file. |
|
|
63
69
|
| `logfire-mcp-core` | Pure, I/O-free decision core for global input/output, envelope, limit, and error-category contracts. |
|
|
64
|
-
| `logfire-mcp-client` | Official `rmcp` transport,
|
|
70
|
+
| `logfire-mcp-client` | Official `rmcp` transport, MCP challenge and token-exchange policy, bounded protocol I/O, and protocol-faithful fakes. |
|
|
71
|
+
| `logfire-oauth` | Platform OAuth, strict SDK/HTTP policy, loopback callback, and confidential session lifecycle. |
|
|
65
72
|
|
|
66
73
|
See [`dev-docs/ARCHITECTURE.md`](dev-docs/ARCHITECTURE.md) for the product
|
|
67
74
|
boundaries and trust model, and [`dev-docs/CRATE_RULES.md`](dev-docs/CRATE_RULES.md)
|
|
68
|
-
for each crate's dependency and I/O contract.
|
|
75
|
+
for each crate's dependency and I/O contract. The
|
|
76
|
+
[`assurance model`](dev-docs/ASSURANCE_MODEL.md) maps critical invariants to unit,
|
|
77
|
+
property, state-machine, mutation, boundary, smoke, and end-to-end evidence.
|
|
69
78
|
|
|
70
79
|
### Design notes
|
|
71
80
|
|
|
72
81
|
- **No `unsafe`.** The workspace sets `unsafe_code = "forbid"`; safe `std`/`nix`
|
|
73
82
|
APIs have covered every need, and `forbid` (unlike `deny`) can't be overridden
|
|
74
83
|
locally.
|
|
75
|
-
- **Small release binary.** The release profile trades
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
84
|
+
- **Small release binary.** The release profile trades compile time for size
|
|
85
|
+
(`opt-level = "z"`, fat LTO, one codegen unit, `strip`, `panic = "abort"`).
|
|
86
|
+
Because `panic = "abort"` skips unwinding, the accepted trade-off is that a
|
|
87
|
+
task panic aborts the whole process without running destructors instead of
|
|
88
|
+
ending only that task.
|
|
80
89
|
- **TLS via `ring`, not `aws-lc`.** `reqwest`/`rustls` use the `ring` crypto
|
|
81
90
|
provider — much smaller, and no `cmake` at build time. Trade-off: `ring` cannot
|
|
82
91
|
verify P-521-signed certificates, so TLS can fail behind a corporate
|
package/bin/logfire
CHANGED
|
Binary file
|
package/package.json
CHANGED