convez.ai
SkillDesenvolvimento WebIntermediário
mthds-ai

MTHDS Plugins

mthds-ai/mthds-plugins

Toolkit completo para build, validação e execução de métodos de IA em MTHDS

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill abrangente para Claude Code e OpenAI Codex que transforma agentes de IA em especialistas na linguagem MTHDS. Fornece CLIs integradas para construir, validar, executar e compartilhar métodos de IA em formato .mthds, com gerenciamento completo de instalação e atualização.

Instalação

$npx convez-ai mthds-ai/mthds-plugins

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Construir e validar bundles de métodos de IA reutilizáveis
  • Automatizar linting, formatação e execução de workflows em MTHDS
  • Gerenciar versões e compartilhar métodos via hub centralizado

Veredito

Plugin robusto e bem documentado que eleva agentes de IA a ferramentas produtivas para engenharia de métodos. Excelente para equipes que trabalham com padrões de IA reutilizáveis, mas requer familiaridade prévia com MTHDS e Node.js.

README

A tradução para o português deste README ainda está na fila.

MTHDS Plugins

A skills plugin for Claude Code and OpenAI Codex for building, running, validating, and editing AI methods (.mthds bundle files).

MTHDS is an open standard for AI methods. Find methods on the hub: MTHDS Hub. Install the reference python runtime from Pipelex.

Install for Claude Code

Open Claude Code and paste this. Claude does the rest.

Install mthds: run bash -c 'npm install -g mthds && mthds-agent bootstrap && claude plugin marketplace add mthds-ai/mthds-plugins && claude plugin install mthds@mthds-plugins'. Then tell me to /reload-plugins.

Manual install (Claude Code)

npm install -g mthds
mthds-agent bootstrap
claude plugin marketplace add mthds-ai/mthds-plugins
claude plugin install mthds@mthds-plugins

Install for Codex

Open Codex and paste this. Codex does the rest.

Install mthds: run bash -c 'npm install -g mthds && mthds-agent bootstrap && mthds-agent codex apply-config && codex plugin marketplace add mthds-ai/mthds-plugins'. Then tell me to restart Codex and run /plugins to install mthds.

Requires Codex 0.130.0+ (plugin-bundled hooks shipped in 0.130). Bump with npm install -g @openai/codex@latest if needed.

Manual install (Codex)

npm install -g mthds
mthds-agent bootstrap                # uv + plxt + pipelex-agent
mthds-agent codex apply-config       # set up ~/.codex/ for the mthds plugin
codex plugin marketplace add mthds-ai/mthds-plugins
# Restart Codex, then run /plugins to install mthds

The .mthds validation hook ships inside the plugin (hooks/codex-hooks.json, declared in the Codex plugin manifest); Codex discovers it directly once the plugin is installed — there is no per-user hook wiring step.

mthds-agent codex apply-config makes one-time additive changes to ~/.codex/config.toml:

  • [features] plugin_hooks = true — Codex only loads plugin-bundled hooks when this is enabled.
  • [sandbox_workspace_write] network_access = true — Codex's default workspace-write sandbox otherwise blocks outbound network for hook commands.

It also removes any obsolete ~/.codex/hooks.json entry left by older mthds installs (which used a now-retired install-hook step). The command is idempotent and never overwrites unrelated config — use --dry-run to preview, --check for CI/env-check. See docs/codex-vs-claude-hooks.md.

If mthds gets installed without this step (for example, added straight from the marketplace UI), the skills catch it: their Step 0 env-check detects the gap and offers to run apply-config for you. Running it up front just avoids building your first method before the validation hook is live.

Skills

Skills work identically on both Claude Code (/skill-name) and Codex ($skill-name).

SkillDescription
mthds-upgradeUpgrade MTHDS stack to latest version
mthds-buildBuild new AI method bundles from scratch
mthds-checkValidate workflow bundles (read-only)
mthds-editModify existing bundles
mthds-explainExplain and document workflows
mthds-fixAuto-fix validation errors
mthds-runExecute methods and interpret output
mthds-inputsPrepare inputs: templates, synthetic data, files
mthds-installInstall method packages from GitHub or local
mthds-runner-setupSet up inference backends and API keys
mthds-pkgManage MTHDS packages (init, deps, lock)
mthds-publishPublish methods to mthds.sh
mthds-shareShare methods on social media
mthds-vibeWrite a complete MTHDS bundle directly in a single pass

Automatic validation

Both plugins include hooks that validate .mthds files automatically:

  1. Lint — plxt lint validates TOML structure and schema
  2. Format — plxt fmt auto-formats the file
  3. Validate — mthds-agent validate bundle checks semantic correctness

Claude Code: A PostToolUse hook matches Write/Edit and receives the file path directly. Errors block the edit immediately.

Codex: A PostToolUse hook matches apply_patch (Codex's file-write tool) and parses the patch envelope to find every touched .mthds file. Same per-edit validation, same immediate feedback.

Missing tools (plxt, mthds-agent) block .mthds edits until installed.

License

MIT — Copyright (c) 2026 Evotis S.A.S.

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

Ver o original no GitHub

Bom para

Relacionados