stfade/moth

Overview

A debugging workflow plugin for AI coding agents that captures terminal failures and applies structured skills via MCP to generate source-backed fixes. It integrates into agent toolchains to automate recovery from build, test, and runtime errors.

Best for

Best for
Developers using AI coding agents who want automated error recovery from terminal logs

Use cases

• Automatically fixing compile errors in agent-driven development
• Resolving test failures from terminal output in CI workflows
• Recovering from runtime exceptions during code generation sessions

How to use

Install

npm install -g @stfade/moth && moth-mcp

Tools exposed

• analyze_error
• remember_fix_result

Tested with

Codex, Claude Code, Cursor, Gemini CLI, Gemini Antigravity, OpenCode, Generic MCP

Example client config

{\n  "mcpServers": {\n    "moth": {\n      "command": "npx",\n      "args": ["-y", "@stfade/moth", "moth-mcp"]\n    }\n  }\n}

Notes

A debugging workflow plugin for AI coding agents that captures terminal failures and applies structured skills via MCP to generate source-backed fixes. It integrates into agent toolchains to automate recovery from build, test, and runtime errors.

1 stars on GitHub. Last updated 2026-05-04. Licensed MIT.

Use cases

• Automatically fixing compile errors in agent-driven development
• Resolving test failures from terminal output in CI workflows
• Recovering from runtime exceptions during code generation sessions

Pros

• Translates terminal errors directly into source-backed fixes
• Leverages MCP for standardized agent-to-tool communication
• Reduces manual debugging iteration for agent developers

Cons

• Very early stage with only 1 GitHub star, limited community validation
• Requires MCP-compatible terminals and agent frameworks
• Error coverage may be sparse for niche languages or complex failures

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.