Threesmith
Node.js 22.12+ · three installed in the project

Install Threesmith

It runs locally over stdio with npx: nothing to clone or build, no API key. Run your agent from the project folder, or pass --project <path>.

Claude Code: the plugin (recommended)

The MCP server plus hooks (each edited three.js file is reviewed, broken asset paths named, errors in command output explained), 8 skills and 2 subagents.

/plugin marketplace add laaielichter/Threesmith
/plugin install threesmith@threesmith

MCP server only: claude mcp add threesmith -- npx -y threesmith mcp. Hooks off: THREESMITH_HOOKS=0.

Codex

codex mcp add threesmith -- npx -y threesmith mcp --tier premium

Cursor

Add to Cursor

Or in .cursor/mcp.json:

{ "mcpServers": { "threesmith": { "command": "npx", "args": ["-y", "threesmith", "mcp"] } } }

VS Code (Copilot agent mode)

Install in VS Code

Or in .vscode/mcp.json:

{ "servers": { "threesmith": { "command": "npx", "args": ["-y", "threesmith", "mcp"] } } }

Gemini CLI

gemini extensions install https://github.com/laaielichter/Threesmith

Cline, Windsurf, Zed and any MCP client

{
  "mcpServers": {
    "threesmith": {
      "command": "npx",
      "args": ["-y", "threesmith", "mcp", "--project", "/absolute/path/to/your/project"]
    }
  }
}

Agents that install servers themselves can follow llms-install.md. Docker: the Dockerfile in the repository.

Options

OptionEnvironmentWhat it does
--tier cheap | premiumTHREESMITH_TIERcheap (default): short, capped output and numbered steps for small models; premium: full detail
--tools core,runTHREESMITH_TOOLSload only these sets (core, run, live, build, model, all) or single tools
--read-onlyTHREESMITH_READ_ONLY=1leave out tools that always write, refuse write options; dry runs still work
--project <dir>THREESMITH_PROJECTthe folder tools use when no path is given
—THREESMITH_PROTECTfolders no write may touch (also "protect" in threesmith.json)
—THREESMITH_LEARN=0no local learning (false-alarm feedback)

Browser tools

three_check, three_inspect, three_play, three_perf, three_leaks, three_session and three_build need playwright-core and a Chromium:

npm i -D playwright-core
npx playwright-core install chromium
npx threesmith doctor --env     # what is missing

Or set THREESMITH_CHROMIUM to a Chromium binary. Everything else works without a browser.