Metadata-Version: 2.4
Name: pipelex-tools
Version: 0.2.3
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
pip install pipelex-tools
```

```bash
uv add 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 |

## Configuration

`plxt` discovers configuration in this order:

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

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

