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>.
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 mcp add threesmith -- npx -y threesmith mcp --tier premium
Or in .cursor/mcp.json:
{ "mcpServers": { "threesmith": { "command": "npx", "args": ["-y", "threesmith", "mcp"] } } }
Or in .vscode/mcp.json:
{ "servers": { "threesmith": { "command": "npx", "args": ["-y", "threesmith", "mcp"] } } }
gemini extensions install https://github.com/laaielichter/Threesmith
{
"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.
| Option | Environment | What it does |
|---|---|---|
--tier cheap | premium | THREESMITH_TIER | cheap (default): short, capped output and numbered steps for small models; premium: full detail |
--tools core,run | THREESMITH_TOOLS | load only these sets (core, run, live, build, model, all) or single tools |
--read-only | THREESMITH_READ_ONLY=1 | leave out tools that always write, refuse write options; dry runs still work |
--project <dir> | THREESMITH_PROJECT | the folder tools use when no path is given |
| — | THREESMITH_PROTECT | folders no write may touch (also "protect" in threesmith.json) |
| — | THREESMITH_LEARN=0 | no local learning (false-alarm feedback) |
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.