| name | mimi-seed-install |
| description | mimi-seed-sdk 를 소스(git clone)에서 설치한다 — 두 패키지 install·build·npm link → Claude Code MCP + Codex marketplace/plugin 등록 → 언어 선택 + 계정 연결(mimi-seed setup)까지. Use when the user has cloned mimi-seed-sdk and asks to install / set it up from source, or when `mimi-seed` is not on PATH in a checkout of this repo. |
mimi-seed 소스 설치
git clone 한 mimi-seed-sdk 체크아웃을 동작하는 설치 상태로 만든다.
배포판(npm/플러그인)을 쓰려는 사용자에게는 이 스킬을 쓰지 않는다 — 그건 README 의 30초 설치가 맞다.
이 스킬은 소스에서 돌리려는 경우(코드 수정, 미배포 기능 사용)에만 쓴다.
0. 사전 확인
node -v
리포 루트인지 확인한다 (packages/cli 와 packages/mcp-server 가 보여야 함). 아니면 사용자에게
clone 위치를 묻는다.
1. 설치 (한 명령)
npm run setup
이게 하는 일 — scripts/install.mjs:
packages/mcp-server → npm install → npm run build → npm linkpackages/cli → npm install → npm run build → npm linkclaude mcp add mimi-seed-dev -- mimi-seed-mcp- Codex marketplace 동기화 →
codex plugin marketplace add → codex plugin add mimi-seed@yoonion
이 리포는 npm 워크스페이스가 아니다. 두 패키지를 각각 설치·빌드해야 하고, 루트
package.json 은 그 부트스트랩 스크립트만 들고 있다.
링크 없이 빌드만 하려면 npm run install:all.
2. MCP·플러그인 등록 확인
claude mcp add 가 성공했으면 사용자에게 새 세션을 시작해야 도구가 보인다고 알린다 —
도구 목록은 세션 시작 시점에 읽는다. 이건 흔한 함정이라 반드시 짚어준다.
Codex 플러그인 설치가 성공했어도 새 대화를 시작해야 스킬과 도구가 보인다. MCP 등록만 성공하고
플러그인 설치가 빠진 상태를 설치 완료로 판단하지 않는다.
등록이 실패했다면(예: claude CLI 없음) 명령만 출력하고 직접 실행하도록 안내한다:
claude mcp add mimi-seed-dev -- mimi-seed-mcp
Codex 등록이 실패했다면 다음을 안내한다:
npm run plugin:sync
codex plugin marketplace add .
codex plugin add mimi-seed@yoonion
3. 언어 + 계정 연결
설치가 끝나면 사용자에게 터미널에서 다음을 실행하라고 안내한다:
mimi-seed setup
첫 실행이면 언어를 먼저 묻고(기본 한국어), 그다음 가진 계정을 순서대로 연결한다.
⚠️ 이 명령을 네가 대신 실행하지 마라. 대화형이라 토큰·비밀번호를 사용자가 직접 입력해야 하고,
에이전트 세션에서 spawn 하면 입력을 받을 수 없다. 명령을 알려주고 결과를 기다린다.
언어만 따로 바꾸려면: mimi-seed lang en / mimi-seed lang ko.
4. 검증
mimi-seed doctor
전체 자격증명 상태 + Node·Git·앱 감지를 보고한다. 여기서 ✓ 가 뜨면 설치 완료다.
소스를 고친 뒤
npm link 는 src/ 가 아니라 dist/ 를 링크한다. 소스를 수정하면 그 패키지에서 다시 빌드해야
링크된 바이너리에 반영된다:
cd packages/cli && npm run build
MCP 서버를 고쳤다면 빌드 후 세션 재시작까지 필요하다.
스킬·문서·.mcp.json·.codex-plugin을 고쳤다면 npm run plugin:sync와
npm run plugin:check를 실행한 뒤 Codex 플러그인을 다시 설치한다.
되돌리기
npm unlink -g mimi-seed
npm unlink -g @yoonion/mimi-seed-mcp
claude mcp remove mimi-seed-dev
더 읽을 것
