The reference toolchain for the MTHDS open standard — editing, formatting, linting, and language-server support for .mthds and .toml files. Built on a Taplo fork. Ships a VS Code / Cursor extension, the plxt CLI, and two PyPI packages: pipelex-tools for the native CLI and pipelex-tools-py for the importable Python library.
What is MTHDS? — An open standard for defining AI methods as typed, composable, human-readable files. A
.mthdsfile describes what an AI should do — its inputs, outputs, logic, and data types — in plain TOML that both people and machines can read. Pipelex is the runtime that executes them. Learn more at docs.pipelex.com.
This repo publishes two separate PyPI packages:
| Package | Use | Source metadata |
|---|---|---|
pipelex-tools |
Native plxt CLI for formatting, linting, and LSP support |
root pyproject.toml |
pipelex-tools-py |
Importable Python library, import pipelex_tools |
crates/pipelex-py/pyproject.toml |
The Pipelex CLI for formatting and linting MTHDS and TOML files. Install via PyPI:
uv tool install pipelex-tools| Command | Description |
|---|---|
plxt fmt |
Format TOML and MTHDS documents |
plxt lint |
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 |
Print default config or its JSON schema |
plxt completions |
Generate shell completions |
Configuration: plxt looks for .pipelex/plxt.toml (preferred) or plxt.toml in your project root (falls back to .taplo.toml).
First-class editing support for .mthds files and TOML — syntax highlighting, semantic tokens, formatting, completions, schema validation, and more.
code --install-extension Pipelex.pipelex
# or
cursor --install-extension Pipelex.pipelexSee editors/vscode/README.md for full details.
- MTHDS language support: Rich syntax highlighting, semantic tokens, and language features for
.mthdsfiles - Concept definitions:
[concept.Name]sections with specialized highlighting - Pipe definitions:
[pipe.name]sections for method steps - Jinja2 template syntax: Colorized highlighting for Jinja2 expressions in prompt fields
- Template variables:
@variableand$variablesyntax for inserting data into Jinja2 templates - Pipelex config discovery:
.pipelex/plxt.tomlorplxt.toml - Complete TOML 1.0.0 support and tooling
plxt and the extension send anonymous usage statistics. The first run says so once per machine:
Pipelex collects anonymous usage statistics: counts of commands, runs, pipe types, models and tokens, and the country your IP address maps to; the address itself is never stored. It never collects your methods, prompts, inputs, outputs, file names or pipe names. To turn it off, run
plxt usage-stats disableor set DO_NOT_TRACK=1. Details: https://docs.pipelex.com/latest/setup/usage-statistics/
In the extension, the same is the Pipelex: Disable Usage Statistics command, and VS Code's own telemetry setting also governs it. PIPELEX_USAGE_STATS=0, or [usage_stats] enabled = false in a project's .pipelex/pipelex.toml, turns them off as well. See docs/features/usage-statistics.md for what is sent and every way to turn it off.
File all issues at this repository.
See the MTHDS language reference for the full standard.
"Pipelex" is a trademark of Evotis S.A.S.
This is the repository for Taplo, a TOML v1.0.0 toolkit, more details on the website.
The project is very young, so bugs and incomplete features are expected, so any help is welcome!
The correctness of the TOML parsing and decoding is not yet entirely guaranteed (as there is no official 1.0.0 compliance test suite yet).
All kinds of contributions are welcome. Make sure to read the CONTRIBUTING.md first!