Skip to content

A Pipelex extension for VS Code & Cursor, based on taplo, the TOML toolkit written in Rust

License

Notifications You must be signed in to change notification settings

Pipelex/vscode-pipelex

 
 

Repository files navigation

Pipelex VS Code extension banner

vscode-pipelex

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

The Pipelex CLI for formatting and linting MTHDS and TOML files. 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/plxt.toml (preferred) or plxt.toml in your project root (falls back to .taplo.toml).

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.

Features

  • 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
  • Jinja2 template syntax: Colorized highlighting for Jinja2 expressions in prompt fields
  • Template variables: @variable and $variable syntax for inserting data into Jinja2 templates
  • Pipelex config discovery: .pipelex/plxt.toml or plxt.toml
  • Complete TOML 1.0.0 support and tooling

Where to file issues

File all issues at 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

Continuous integration Latest Version Documentation

Website

Taplo

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

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!

About

A Pipelex extension for VS Code & Cursor, based on taplo, the TOML toolkit written in Rust

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 83.8%
  • TypeScript 12.3%
  • JavaScript 1.1%
  • Vue 0.8%
  • Shell 0.7%
  • Makefile 0.6%
  • Other 0.7%