Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

docs: sync reference docs for v0.31.0 release

Louis Choquel3be646fd2434
diff --git a/AGENTS.md b/AGENTS.md
index 90920783e..49a20efdb 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -69,6 +69,12 @@
.venv/bin/pipelex-dev generate-mthds-schema
```
+ - **`generate-error-pages`**: Regenerate the per-class error reference pages under `docs/errors/` (one page per `PipelexError` subclass). Run after adding or renaming an error class. Also available as `make generate-error-pages` (alias `make gep`).
+
+ ```bash
+ .venv/bin/pipelex-dev generate-error-pages
+ ```
+
### Pipelex CLI Commands
To run the Pipelex CLI commands without the logo, you can use the `--no-logo` flag, this will avoid useless tokens in the console output.
diff --git a/CLAUDE.md b/CLAUDE.md
index 92dda9d56..0a0b9f49a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -135,6 +135,12 @@
.venv/bin/pipelex-dev generate-mthds-schema
```
+ - **`generate-error-pages`**: Regenerate the per-class error reference pages under `docs/errors/` — one Markdown page per `PipelexError` subclass, which is what each error's `type_uri` dereferences to. Run after adding or renaming an error class. Pages a maintainer claims with a `<!-- pipelex:authored -->` marker are preserved across runs. Also available as `make generate-error-pages` (alias `make gep`).
+
+ ```bash
+ .venv/bin/pipelex-dev generate-error-pages
+ ```
+
- **`refresh-graph-ui-sri`**: Refetch the pinned graph viewer assets from jsDelivr (`@pipelex/mthds-ui` standalone JS+CSS, `elkjs`) and rewrite `pipelex/graph/reactflow/standalone_assets.py` with new `sha384` Subresource Integrity hashes. Use when bumping the pinned mthds-ui or elkjs version.
```bash
diff --git a/docs/tools/cli/index.md b/docs/tools/cli/index.md
index 61be4e858..13e473e13 100644
--- a/docs/tools/cli/index.md
+++ b/docs/tools/cli/index.md
@@ -20,6 +20,13 @@ The Pipelex CLI is organized into several command groups:
| [**run**](run.md) | Execute pipelines |
| [**build**](build/index.md) | Generate pipelines, runners, and structures |
+## Global flags
+
+These flags work on any `pipelex` command and are position-agnostic — place them anywhere in the invocation:
+
+- `--traceback` - print the full Rich-rendered stack trace before the friendly one-line error. Off by default. Both `pipelex run --traceback pipe ...` and `pipelex run pipe ... --traceback` work.
+- `--no-logo` - suppress the startup logo banner. Handy for clean logs and to save tokens in agent output.
+
## Related CLI Surface
Package manifest management currently lives in the `mthds` CLI: