Threesmith
What it does
three.js for coding agents: version-pinned API and review, assets, headless runs, perf, 3D models.
- Connects 내 컴퓨터에서 실행
- Account or key No key needed
- Category 개발자 도구
함께 쓰기
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
archify
Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
이 순위인 이유
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 10/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 22/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 5 (급상승 탭에서만 사용)
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 14일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
AI에게 설치 맡기기
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server Threesmith을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "threesmith": { "command": "npx", "args": [ "-y", "threesmith", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Threesmith의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
컴퓨터용 Claude 앱 설정 파일 열기
SettingsDeveloperEdit Config
이 설정을 붙여 넣고 저장
{ "mcpServers": { "threesmith": { "command": "npx", "args": [ "-y", "threesmith", "mcp" ] } } }Claude를 끄고 다시 열기
해 보기
Threesmith을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Threesmith을 쓰고 있다고 하거나 답에 Threesmith 도구 이름이 나오면 연결된 거예요
추가 설정 1개 (입력하지 않아도 사용 가능)
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
THREESMITH_CHROMIUMPath to a Chromium binary for three_check (default: Playwright's Chromium)
설명은 아직 영어 원문입니다.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 Threesmith에 연결할 수 없어요
Threesmith는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
대신 이렇게 할 수 있어요
A · Threesmith에 연결되는 앱 쓰기
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
- 먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
B · 개발자 도구에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server Threesmith을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user threesmith -- npx -y threesmith mcp 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Threesmith의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --scope user threesmith -- npx -y threesmith mcpClaude Code에서 /mcp 입력
Threesmith이 목록에 있고 연결됨으로 보이면 돼요
해 보기
Threesmith을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Threesmith을 쓰고 있다고 하거나 답에 Threesmith 도구 이름이 나오면 연결된 거예요
추가 설정 1개 (입력하지 않아도 사용 가능)
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
THREESMITH_CHROMIUMPath to a Chromium binary for three_check (default: Playwright's Chromium)
설명은 아직 영어 원문입니다.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server Threesmith을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "threesmith": { "command": "npx", "args": [ "-y", "threesmith", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Threesmith의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
Threesmith을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Threesmith을 쓰고 있다고 하거나 답에 Threesmith 도구 이름이 나오면 연결된 거예요
추가 설정 1개 (입력하지 않아도 사용 가능)
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
THREESMITH_CHROMIUMPath to a Chromium binary for three_check (default: Playwright's Chromium)
설명은 아직 영어 원문입니다.
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
AI에게 설치 맡기기
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server Threesmith을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "threesmith": { "type": "stdio", "command": "npx", "args": [ "-y", "threesmith", "mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Threesmith의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Node.js 설치 (아직 없다면)
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -v- 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
- "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법
Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다:
node -v한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
Threesmith을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Threesmith을 쓰고 있다고 하거나 답에 Threesmith 도구 이름이 나오면 연결된 거예요
추가 설정 1개 (입력하지 않아도 사용 가능)
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
THREESMITH_CHROMIUMPath to a Chromium binary for three_check (default: Playwright's Chromium)
설명은 아직 영어 원문입니다.
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
개발자용: 터미널 명령과 JSON 설정
컴퓨터에 설치
Claude Code
claude mcp add --scope user threesmith -- npx -y threesmith mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"threesmith": {
"command": "npx",
"args": [
"-y",
"threesmith",
"mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"threesmith": {
"command": "npx",
"args": [
"-y",
"threesmith",
"mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"threesmith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"threesmith",
"mcp"
]
}
}
}직접 입력할 값
THREESMITH_CHROMIUMenvPath to a Chromium binary for three_check (default: Playwright's Chromium)
설명은 아직 영어 원문입니다.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 16일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 laaielichter 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 어제
- ✓ 통과
라이선스 있음
MIT 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
공개된 취약점 (OSV.dev)
OSV.dev에 threesmith@0.3.0 항목이 없습니다
이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 15일
제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/laaielichter-threesmith)토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 5955개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 5955개 중 90%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 5955개 중 100%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
Threesmith, 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(0.3.0)은 4일 전 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
비슷하게 동작하는 다른 것
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 이 항목 Threesmith | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 라이선스 | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
Threesmith Less debugging. More dimension.
MCP server, CLI and Claude Code plugin. Works with Claude Code, Codex, Cursor, VS Code, Gemini CLI and any MCP client.
Website · Install in your agent · 3D models · Example · Changelog
Explore the interactive model preview , toolkit and real before-and-after demo.
Real run on examples/agent-mistakes : as the agent wrote it (3 review errors, 2 asset paths that 404, a black canvas), and after threesmith fix plus the fixes threesmith doctor listed ( 100/100, check passes ).
three.js ships a release almost every month and removes old APIs. Coding agents learned it from years of code that used THREE.Geometry, outputEncoding, three/examples/js and import paths that no longer exist, and they cannot see the canvas they draw on. Threesmith is the check between the agent and your project: the API of the three version you have installed, a scored review, the assets and decoders the code needs, the live scene in headless Chromium, and safe, undoable edits. Everything runs locally; nothing leaves the machine.
Without and with
| Your agent... | On its own | With Threesmith |
|---|---|---|
| writes three.js | Geometry, outputEncoding, BoxBufferGeometry, examples/js: old habits | 98 rules pinned to the installed release flag each line with the fix; fix does the 23 pure renames |
| calls an API | guesses a name or an import path from memory | three_api reads node_modules/three: signature, deprecation and the right three/addons/... path |
| writes a shader | #include , gl_FragColor with GLSL3, a .replace() on a chunk that is gone | includes checked against the installed ShaderChunk, patches that silently do nothing found, renames fixed |
| loads a model | /models/Car.glb that is a 404 on Linux, Draco without a decoder | three_assets resolves every path like the server does and names the missing decoder setup |
| says "it works" | never opened the page | three_check opens it headless: errors with causes, blank frames, a screenshot, baselines |
| gets a black screen | guesses: more light? move the camera? | three_inspect reads the live scene and says why each object is not visible |
| fixes a bug | cannot show it was there, or that it is gone | three_play runs steps and judges claims frame by frame; three_scenario keeps it as a regression test |
| makes it fast | changes things and hopes | three_perf counts draw calls, triangles and programs against a budget and the last run; three_leaks names what is never disposed |
| ships it | builds once, deploys, sees a 404 | three_build builds, finds two copies of three, missing assets and sub-path URLs, then opens the built page |
| needs a 3D model | needs Blender or a placeholder cube | three_model_build makes a clean .glb from one of 110 kinds, then shows it as text views and lints it |
| does not know the project | reads twenty files | three_scan and three_doctor give the map and the order to fix things in one call |
3D models from code, no Blender: 110 ready-made kinds, from cars and airships to swords, teapots and golems, rendered here by three.js itself. See all
Quickstart
1. See what is wrong. Nothing to install but the package:
npx -y threesmith doctor # what is wrong, grouped by cause, most urgent first, with next steps
npx -y threesmith review # score 0-100, file:line severity [rule] message Fix: ... npx -y threesmith check . # open the page headless, errors and a screenshot
2. Give it to your agent. In Claude Code:
/plugin marketplace add laaielichter/Threesmith
/plugin install threesmith@threesmith
3. Ask for something. *"Find out why the scene is black and fix it."* Every three.js file Claude edits is reviewed right after the edit, its errors and broken asset paths go straight back to Claude, and the session starts with a brief of the project.
Install in your agent
| Client | How |
|---|---|
| Claude Code | /plugin install threesmith@threesmith after /plugin marketplace add laaielichter/Threesmith (MCP server, hooks incl. protected paths, 8 skills, 2 subagents, settings for tool sets and read-only) |
| Claude Code, MCP only | claude mcp add threesmith -- npx -y threesmith mcp |
| Codex | codex mcp add threesmith -- npx -y threesmith mcp --tier premium |
| Cursor, VS Code | the buttons at the top |
| Gemini CLI | gemini extensions install https://github.com/laaielichter/Threesmith |
| Cline and others | llms-install.md, or { "mcpServers": { "threesmith": { "command": "npx", "args": ["-y", "threesmith", "mcp"] } } } |
| Docker | Dockerfile |
Run the agent from the project folder, or pass --project . Needs Node.js 22.12+ and three installed in the project. The browser tools need playwright-core and a Chromium (npx playwright-core install chromium); threesmith doctor --env shows what is missing.
Made for agents: cheap calls, exact answers
- Two profiles.
--tier cheap(the default) gives short, capped output and numbered step-by-step instructions, so small models follow the right order;--tier premiumgives full detail for large models. - Tool sets.
--tools coreloads 14 tools; addrun,live,build,modelwhen you need them, or name single tools. A tool list the client pays for in every turn stays small. The server instructions only ever name tools that are loaded. - Fix loops that cost less.
three_reviewwithonly_new: trueshows new findings in full, the ones the agent already saw as one short line, and how many are fixed.code+filereviews code before it is saved. - Structured results. Review, check and doctor return
structuredContentwith an output schema next to the text. - One line per finding.
file:line severity [rule] message Fix: ..., the same in the CLI (--compact), MCP and hooks. - Safe writes. Every write (fix, model build, scenario save) is one journal entry that
three_undotakes back; a file changed by hand since is left alone."protect"inthreesmith.json(orTHREESMITH_PROTECT) names folders no write may touch.--read-onlyleaves out the tools that always write and refuses write options. - It learns, locally. A finding marked as a false alarm with
three_feedbackis hidden from then on; lessons kept withthree_lesson_addcome back under the same error. Only hashes, counters and scrubbed text, on this machine.
The 31 tools
All MCP tools (most are also CLI commands)
| Set | Tool | What it does |
|---|---|---|
| core | three_doctor | Start here when something is broken: versions and imports, why the scene shows nothing, assets that will not load, removed APIs, colour, performance and cleanup, grouped by cause, most urgent first, with what three_fix does and numbered next steps |
| core | three_scan | Map the project: bundler and framework, three vs @types/three vs package.json, the libraries around it, pages and import maps, every file that uses three with what it creates and where its loop is, renderer settings, assets |
| core | three_api | Exact API of a class, member or constant in the installed three: signature, deprecation, import path; did-you-mean for unknown names |
| core | three_search | Find classes, constants and members by part of a name |
| core | three_review | Scored review (0-100) with 98 rules pinned to the installed release; code + file for unsaved code, only_new in a fix loop, files to focus |
| core | three_types | The project's own tsc --noEmit, with each three.js type error answered from the installed release (the member that exists, the real import path) |
| core | three_fix | The renames that mean exactly the same, dry run first, undoable |
| core | three_explain | Cause and fix of a console, build or test message (35 kinds), with the right import path for the installed release |
| core | three_lessons | 100 lessons from real three.js and react-three-fiber projects (symptom, cause, fix, test) by error message, words, rule or topic |
| core | three_lesson_add | Keep a lesson learned here, scrubbed of names, paths and code; it comes back under the same error |
| core | three_rules | Every review rule with its category, release gating and fix |
| core | three_feedback | Mark a finding as a false alarm (hidden from then on) or right |
| core | three_undo | Undo the last Threesmith writes, newest first |
| core | three_version | Which three release is installed |
| run | three_check | Headless Chromium (software WebGL 2): console and page errors with causes, shader errors at your file and line, failed requests, no context, lost context, blank frames, screenshot, baselines with a diff, interaction steps |
| run | three_inspect | The live scene graph, camera, draw calls, GPU memory growth, and why each object is not visible |
| run | three_play | Steps (click, press, hold, drag, wheel, frames, eval, until), watched values per frame and step, claims judged at the end, any moment or every frame |
| run | three_scenario | Keep a passing play run as a regression test in .threesmith/scenarios/; `c