@pydantic/logfire-cli-darwin-x64 0.1.1 → 0.1.3
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 +19 -7
- 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,15 +21,19 @@ 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
26
|
| [`logfire project`](docs/commands/project.md) | Validate and show the configured SDK project |
|
|
27
|
+
| [`logfire setup`](docs/commands/setup.md) | Hand off repository instrumentation to Codex or Claude Code |
|
|
28
|
+
| [`logfire skill`](docs/commands/skill.md) | Discover and run CLI-bundled Logfire agent skills |
|
|
24
29
|
| [`logfire token`](docs/commands/token.md) | Mint a project read/write token and print it |
|
|
25
30
|
| [`logfire api-key`](docs/commands/api-key.md) | Mint a project-scoped API key and print it |
|
|
26
31
|
| [`logfire api`](docs/commands/api.md) | Typed Platform API endpoints |
|
|
27
32
|
| [`logfire mcp`](docs/commands/mcp.md) | Discover and call the public Logfire MCP server |
|
|
28
33
|
| [`logfire doctor`](docs/commands/doctor.md) | Diagnose local prerequisites without exposing secrets |
|
|
29
34
|
|
|
30
|
-
Every command and group accepts
|
|
35
|
+
Every command and group accepts concise `-h`/`--help`; use
|
|
36
|
+
`logfire help <command>` for the detailed option reference.
|
|
31
37
|
|
|
32
38
|
## Documentation
|
|
33
39
|
|
|
@@ -40,7 +46,10 @@ The [**User Guide**](docs/README.md) covers everything in task-oriented pages:
|
|
|
40
46
|
Global options apply before or after every command. `--region us|eu` (env
|
|
41
47
|
`PYDANTIC_LOGFIRE_REGION`) chooses a hosted region, while `--base-url <URL>`
|
|
42
48
|
(env `LOGFIRE_BASE_URL`) targets a self-hosted or staging instance and overrides
|
|
43
|
-
it. `--
|
|
49
|
+
it. `--org <ORGANIZATION>` selects a saved organization-specific OAuth profile;
|
|
50
|
+
`logfire auth status` lists profiles and `logfire auth switch <ORGANIZATION>`
|
|
51
|
+
changes the default without opening the credential store.
|
|
52
|
+
`--output human|json|jsonl`, `--no-input`, and `--color auto|always|never`
|
|
44
53
|
provide the shared presentation and prompting contract.
|
|
45
54
|
|
|
46
55
|
## Architecture
|
|
@@ -52,15 +61,18 @@ The CLI is a Cargo workspace of small, single-purpose crates:
|
|
|
52
61
|
| `logfire-cli` | The `logfire` binary: argument parsing (clap) and command dispatch. |
|
|
53
62
|
| `logfire-api` | The typed `logfire api` command surface over the generated client. |
|
|
54
63
|
| `logfire-api-client` | Generated from the OpenAPI schemas (see below); never hand-edited. |
|
|
55
|
-
| `logfire-auth` |
|
|
64
|
+
| `logfire-auth` | Terminal UX, organization verification, and profile persistence around browser OAuth. |
|
|
56
65
|
| `logfire-config` | Credential resolution, regions / base-URL, and the request context. |
|
|
57
66
|
| `logfire-init` | `logfire init` project setup and the `.logfire/` credentials file. |
|
|
58
67
|
| `logfire-mcp-core` | Pure, I/O-free decision core for global input/output, envelope, limit, and error-category contracts. |
|
|
59
|
-
| `logfire-mcp-client` | Official `rmcp` transport,
|
|
68
|
+
| `logfire-mcp-client` | Official `rmcp` transport, MCP challenge and token-exchange policy, bounded protocol I/O, and protocol-faithful fakes. |
|
|
69
|
+
| `logfire-oauth` | Platform OAuth, strict SDK/HTTP policy, loopback callback, and confidential session lifecycle. |
|
|
60
70
|
|
|
61
71
|
See [`dev-docs/ARCHITECTURE.md`](dev-docs/ARCHITECTURE.md) for the product
|
|
62
72
|
boundaries and trust model, and [`dev-docs/CRATE_RULES.md`](dev-docs/CRATE_RULES.md)
|
|
63
|
-
for each crate's dependency and I/O contract.
|
|
73
|
+
for each crate's dependency and I/O contract. The
|
|
74
|
+
[`assurance model`](dev-docs/ASSURANCE_MODEL.md) maps critical invariants to unit,
|
|
75
|
+
property, state-machine, mutation, boundary, smoke, and end-to-end evidence.
|
|
64
76
|
|
|
65
77
|
### Design notes
|
|
66
78
|
|
package/bin/logfire
CHANGED
|
Binary file
|
package/package.json
CHANGED