Mechanic Development Hub

Mechanic combines a desktop tool and two in-game addons. Agents use it through MCP; people also use the CLI and the web dashboard.

Architecture

Mechanic Desktop (desktop/)                       commands.list = the single registry
  MCP server (mech mcp)   CLI (mech)   Dashboard (/dashboard/, same commands via /api/execute)
        |  reads !Mechanic.lua (SavedVariables holding MechanicDB, one file per account)
        |  writes MechanicQueue.lua (Lua / API test queue) into the !Mechanic addon folder
!Mechanic   (bootstrap, loads first)  owns MechanicDB, MechanicLib-1.0, queue execution
Mechanic    (main addon, /mech)       Console, Errors, Tests, Inspect, Performance, Tools, API

SavedVariables are written by the game on /reload or logout, so desktop reads are only fresh after a confirmed reload (using-mechanic).

Agents: MCP tools

Call tools directly; discover inputs with commands.list or the generated command reference. Pick a diagnostic.targets entry and reuse it for queue and read calls. Do not use the shell or mech CLI for agent work.

Components

• MCP server: mech mcp (stdio by default, configured in the repo's .mcp.json). Exposes every registered command with dashed names. Optional SSE transport (--transport sse, default 127.0.0.1:3101) is unauthenticated and exposes mutating commands; never expose it.
• CLI (mech or mechanic): user fallback. See cli-commands.
• Dashboard: mech dashboard serves http://127.0.0.1:3100/dashboard/. See dashboard.
• In-game hub: the Mechanic addon (/mech). See ingame-modules.
• MechanicLib: LibStub("MechanicLib-1.0", true); Register, Log, IsEnabled, watch list. See mechaniclib.

local MechanicLib = LibStub("MechanicLib-1.0", true)
if MechanicLib then
    MechanicLib:Register("MyAddon", { version = "1.0.0" })
    MechanicLib:Log("MyAddon", "loaded", MechanicLib.Categories.LOAD)
end

Routing

Request type	Load reference
Every command, input, mutation flag (generated)	../using-mechanic/references/afd-commands.md
CLI (user-facing)	references/cli-commands.md
Dashboard, HTTP routes, WebSocket	references/dashboard.md
In-game tabs and slash commands	references/ingame-modules.md
MechanicLib API	references/mechaniclib.md
Changing the desktop tool itself	k-desktop