Metadata-Version: 2.4
Name: pipelex-tools
Version: 0.11.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Quality Assurance
License-File: LICENSE
Summary: Pipelex Tools CLI — MTHDS/TOML formatter, linter, and LSP
Keywords: toml,mthds,pipelex,linter,formatter
Home-Page: https://docs.pipelex.com/
Author: tamasfe
Author-email: "Evotis S.A.S." <oss@pipelex.com>
Maintainer-email: Pipelex staff <oss@pipelex.com>
License-Expression: MIT
Requires-Python: >=3.8, <3.15
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/Pipelex/vscode-pipelex/blob/main/CHANGELOG.md
Project-URL: Documentation, https://docs.pipelex.com/
Project-URL: Homepage, https://github.com/Pipelex/vscode-pipelex
Project-URL: Repository, https://github.com/Pipelex/vscode-pipelex.git
Project-URL: Tracker, https://github.com/Pipelex/vscode-pipelex/issues

# pipelex-tools

CLI for formatting, linting, and language-server support for MTHDS and TOML files.

> **What is MTHDS?** — An open standard for defining AI methods as typed, composable, human-readable files. A `.mthds` file describes what an AI should do — its inputs, outputs, logic, and data types — in plain TOML that both people and machines can read. [Pipelex](https://github.com/Pipelex/pipelex) is the runtime that executes them. Learn more at [docs.pipelex.com](https://docs.pipelex.com).

## Installation

```bash
uv tool install pipelex-tools
```

```bash
pipx install pipelex-tools
```

## Commands

| Command | Description |
|---------|-------------|
| `plxt format` (alias `fmt`) | Format TOML and MTHDS documents |
| `plxt lint` (aliases `check`, `validate`) | Lint TOML and MTHDS documents |
| `plxt lsp stdio` | Start the language server (stdio transport) |
| `plxt get` | Extract a value from a TOML document |
| `plxt config default` | Print the default configuration file |
| `plxt config schema` | Print the JSON schema of the configuration file |
| `plxt completions <shell>` | Generate shell completions |
| `plxt usage-stats status` | Show whether anonymous usage statistics are on, and what turns them off (also `disable`, `enable`, `reset-id`) |

## Configuration

`plxt` discovers configuration in this order:

1. `.pipelex/plxt.toml` (preferred)
2. `plxt.toml`
3. `.taplo.toml` (fallback)

## Usage statistics

`plxt` sends anonymous usage statistics: which of `format`, `lint`, `get` and `config` ran, how it ended, how long it took, how many files it processed in buckets and how many diagnostics it reported by kind. It never sends your methods, prompts, inputs, outputs, file names or pipe names, and `plxt lsp` sends nothing. The first run says so once per machine on stderr. Turn them off with `plxt usage-stats disable`, `DO_NOT_TRACK=1`, `PIPELEX_USAGE_STATS=0`, or `[usage_stats] enabled = false` in a project's `.pipelex/pipelex.toml`. Details: [docs.pipelex.com/latest/setup/usage-statistics](https://docs.pipelex.com/latest/setup/usage-statistics/).

## MTHDS Example

<img src="https://d2cinlfp2qnig1.cloudfront.net/images/mthds-sample-code.png" alt="MTHDS sample code" width="800" style="max-width: 100%; height: auto;">

See the [MTHDS language reference](https://docs.pipelex.com) for the full standard.

## VS Code / Cursor Extension

For rich editor support (syntax highlighting, semantic tokens, formatting, completions, schema validation), install the [Pipelex extension](https://marketplace.visualstudio.com/items?itemName=Pipelex.pipelex) for VS Code or Cursor.

## Links

- [GitHub](https://github.com/Pipelex/vscode-pipelex)
- [Documentation](https://docs.pipelex.com)
- [Issues](https://github.com/Pipelex/vscode-pipelex/issues)

---

TOML support built on [Taplo](https://github.com/tamasfe/taplo).

"Pipelex" is a trademark of Evotis S.A.S.

