Skip to content

docs(README): clarify install step 2 dependency and /mcp empty case#1

Open
namojo wants to merge 2 commits into
mainfrom
docs/installation-guide-clarifications
Open

docs(README): clarify install step 2 dependency and /mcp empty case#1
namojo wants to merge 2 commits into
mainfrom
docs/installation-guide-clarifications

Conversation

@namojo

@namojo namojo commented Apr 29, 2026

Copy link
Copy Markdown
Owner

Summary

테스터 피드백("4)까지 했는데 5)에서 /mcp list·/commands가 비어 있다", "requirements.txt가 없다") 해결을 위한 README 보강. 한·영 README 동일 변경 적용.

  • 1) 패키지 설치 직후: pyproject.toml이 의존성의 단일 소스(SoT)이며 pip가 자동 해결한다는 점, 별도 requirements.txt를 두지 않는 이유, lock이 필요할 때의 권장 방법(pip-compile) 명시.
  • 5) 설치 확인 직전: 2) 익스텐션 등록을 건너뛰면 출력이 비어 있다는 점과, /mcp list·/commands는 매니페스트만 읽기 때문에 모델 설정과 무관하다는 점을 강조.
  • Troubleshooting: /mcp list 또는 /commands에 harness가 보이지 않음 항목을 신설. 진단 명령(gemini --version, gemini extensions list, gemini extensions install, which gemini-harness-mcp) 4줄 + 컨테이너/root 환경 주의사항 포함. 기존 🔴 Disconnected 항목은 "익스텐션은 등록됐지만 서버 프로세스 실패" 케이스와 명확히 분리되도록 도입부 한 줄 보강.

Test plan

  • README.md / README_EN.md 렌더링 확인 (callout, anchor 링크 동작)
  • Troubleshooting 새 항목의 anchor가 5단계에서 정상 점프 (KO: #mcp-list-또는-commands에-harness가-보이지-않음, EN: #mcp-list-or-commands-doesnt-show-harness)

namojo added 2 commits April 30, 2026 01:04
… /mcp empty case

- 1) 패키지 설치: pyproject.toml이 의존성 단일 소스이며 requirements.txt를 두지 않는 이유 명시
- 5) 설치 확인: 익스텐션 등록(2단계)이 선행되어야 하며 모델 설정과 무관함 강조
- Troubleshooting: /mcp list·/commands가 비어 있을 때의 진단 절차 추가 (Disconnected와 분리)
…cations

Same three changes as README.md, translated:
- 1) Install: pyproject.toml as dependency SoT, no requirements.txt
- 5) Verify: callout that step 2 is required and is independent of model config
- Troubleshooting: new "/mcp list or /commands doesn't show harness" entry, separated from Disconnected
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant