# MTHDS

> MTHDS is an open standard for defining, packaging, and sharing typed AI methods — with a hub for discovery, a CLI for installation and execution, and a Claude Code plugin.

MTHDS is an open standard for defining, packaging, and distributing AI methods — discrete, reusable units of cognitive work like extraction, analysis, synthesis, and generation. Methods are written in a declarative language built on TOML, using two primitives: concepts (semantically typed data) and pipes (orchestration steps with explicit inputs and outputs). The typing is conceptual — types carry business meaning, so pipes compose wherever types are compatible without glue code.

The ecosystem includes the MTHDS Hub (mthds.sh) for discovering and sharing methods, a CLI for installing and running them, and a Claude Code plugin for authoring methods in natural language.

- **Declarative .mthds Language** — *Define AI workflows in typed, human-readable TOML files with concepts (semantic types) and pipes (operators and controllers).*
- **Package System** — *Versioned method packages with METHODS.toml manifests, dependency chains, lock files with SHA-256 integrity, and cross-package references.*
- **MTHDS Hub** — *Public registry at mthds.sh for discovering, sharing, and ranking methods by install count — with pipeline flowchart visualization.*
- **CLI** — *Install methods from GitHub repos, set up runners, and execute methods from the terminal via `npx mthds`.*
- **Claude Code Plugin** — *Build, run, edit, check, fix, explain, and publish methods using natural language commands inside Claude Code.*
- **Know-How Graph** — *Typed method discovery by signature — find methods or chains by specifying "I have X, I need Y."*
- **Agent-First Design** — *Methods are executable by agents and outside agent scope entirely — readable by humans, writable by Claude Code, runnable anywhere.*
- **VS Code Extension** — *Syntax highlighting, validation, and autocomplete for .mthds files in VS Code, Cursor, and Windsurf.*

Get started with `npx mthds install org/repo` to install methods, or use the Claude Code plugin to author your own. The reference runtime is Pipelex (MIT).

## Features
- Declarative .mthds language (TOML-based, typed concepts and pipes)
- Semantic type system with concept refinement hierarchies
- 5 pipe operators (LLM, Extract, ImgGen, Search, Compose, Func)
- 4 pipe controllers (Sequence, Parallel, Batch, Condition)
- Working memory for data flow between pipes
- Package system with METHODS.toml manifests
- Versioned dependencies with SHA-256 lock files
- Cross-package references via -> syntax
- MTHDS Hub (mthds.sh) — public method registry ranked by installs
- Pipeline flowchart visualization on the Hub
- CLI (npx mthds) for install, run, and package management
- Claude Code plugin with build, run, edit, check, fix, explain, publish commands
- VS Code / Cursor / Windsurf extension for .mthds syntax
- Know-How Graph for typed signature discovery
- Namespace resolution across domains and packages
- Model references (abstract and concrete) for provider-agnostic methods
- Multiplicity support for batch processing over collections
- Open standard — any runtime can implement it

## Integrations
Pipelex (reference runtime), Claude Code, VS Code, Cursor, Windsurf, GitHub (package distribution)

## Platforms
CLI, WEB

## Pricing
Open Source

## Version
0.1.4

## Links
- Website: https://mthds.ai/latest/
- Documentation: https://mthds.ai/latest/
- Repository: https://github.com/mthds-ai/mthds
- EveryDev.ai: https://www.everydev.ai/tools/mthds