pipelex-tools 0.1.2

Pipelex Tools CLI — MTHDS/TOML formatter, linter, and LSP

vscode-pipelex

This repo is a fork of Taplo extended with MTHDS support. It ships a VS Code / Cursor extension, the plxt CLI, and the pipelex-tools PyPI package.

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 is the runtime that executes them. Learn more at docs.pipelex.com.

plxt CLI

A drop-in replacement for the taplo CLI with Pipelex config discovery. Install via PyPI:

pip install pipelex-tools
# or
uv add 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/toml_config.toml in your project root (falls back to .taplo.toml). Override with the PIPELEX_CONFIG environment variable.

VS Code / Cursor Extension

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

See editors/vscode/README.md for full details.

What we offer in addition to Taplo

• MTHDS language support: Rich syntax highlighting, semantic tokens, and language features for .mthds files
• Concept definitions: [concept.Name] sections with specialized highlighting
• Pipe definitions: [pipe.name] sections for method steps
• Data injection: @variable syntax with smart highlighting
• Template variables: $variable support with Jinja2 templates
• Pipelex config discovery: .pipelex/toml_config.toml with PIPELEX_CONFIG env var
• All Taplo features retained: Complete TOML 1.0.0 support and tooling

Where to file issues

• Taplo behavior/bugs → upstream Taplo project
• MTHDS-specific issues → this repository

MTHDS Example

domain = "hr_screening"
description = "Analyze a job offer to build a scorecard, batch process CVs"
main_pipe = "screen_candidates"

[concept.Scorecard]
description = "Evaluation scorecard built from a job offer"

[concept.Scorecard.structure]
job_title = { type = "text", required = true }
company = { type = "text" }
required_skills = { type = "list", item_type = "text" }
criteria = { type = "list", item_type = "concept", item_concept_ref = "hr_screening.Criterion" }

[pipe.screen_candidates]
type = "PipeSequence"
inputs = { job_offer = "Document", cvs = "Document[]" }
output = "CvResult[]"
steps = [
    { pipe = "extract_job_offer", result = "job_pages" },
    { pipe = "build_scorecard", result = "scorecard" },
    { pipe = "evaluate_cv", batch_over = "cvs", result = "results" },
]

[pipe.build_scorecard]
type = "PipeLLM"
inputs = { job_pages = "Page[]" }
output = "Scorecard"
model = "claude-4.6-opus"
prompt = """Analyze this job offer and build a scorecard..."""

See the MTHDS language reference for the full standard.

---

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

---

Original Taplo README (kept in sync)

Website

Taplo

This is the repository for Taplo, a TOML v1.0.0 toolkit, more details on the website.

• Taplo
  • Status
  • Contributing

Status

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

Contributing

All kinds of contributions are welcome. Make sure to read the CONTRIBUTING.md first!