omm

omm doctor

실제로 어느 바이너리가 실행되는지, 패키지와 소스 버전이 맞는지, 레지스트리가 Ollama가 실제로 보는 것과 일치하는지 — omm 설치 자체와 Ollama 링크를 아무것도 바꾸지 않고 진단합니다.

01 / 06

개요

omm 자체가 뭔가 이상할 때 — 다른 버전이 실행되거나, 업데이트 후 명령을 못 찾거나, omm은 링크됐다고 생각하는데 Ollama는 실제로 못 보는 모델이 있거나 — 추측 대신 구조화된 답이 필요할 때 쓰는 명령입니다. 모든 검사는 읽기 전용입니다: 찾아낸 걸 자동으로 고치지 않고, 두 번 연속 실행해도 두 번째 결과가 절대 바뀌지 않습니다.

02 / 06

옵션

이 명령이 받는 모든 옵션과, 생략했을 때의 기본값입니다.

  • --json—기본값: off

    같은 검사를 표 대신 구조화된 JSON으로 출력합니다.

03 / 06

예제

기본 검색부터 스크립트에 넣을 만한 형태까지.

전체 진단 표.

$ omm doctor

같은 검사를 JSON으로.

$ omm doctor --json

같은 진단을, 진행 출력 없이.

$ omm doctor --quiet

04 / 06

실제 실행 예시

2026-08-25, 이 개발 머신에서 실제로 실행한 omm doctor 캡처입니다 — 개인 파일 경로는 일반화했고, 그 외 모든 검사 이름·상태·경로 아닌 세부 정보(버전, 커밋, 태그 이름)는 실제 그대로입니다. 이번 실행이 실제로 찾아낸 진짜 WARN(git 편집 가능 설치라 패키지 메타데이터가 소스보다 몇 버전 뒤처진 상태)도 그대로 실었습니다.

06 / 06

문제가 생겼다면

아래 메시지는 모두 이 명령이 실제로 출력하는 것들입니다. 해당하는 메시지를 찾아 원인을 읽고, 마지막 줄대로 하면 됩니다.

  1. Overall: FAIL (N pass, N warn, 1 fail)
    원인
    doctor 자체 설명문이 명확히 밝힙니다: WARN은 절대 명령을 실패시키지 않지만, 진짜 FAIL(예: 완전히 깨진 Ollama 링크)은 실패시킵니다.
    대처
    FAIL 행의 detail 열에서 정확히 뭐가 실패했는지 읽고 그걸 고치세요 — 표가 문제를 정확히 짚어줍니다.
    출처
    src/omm/cli.py:2513-2514

그래도 해결되지 않는다면, 화면에 뜬 메시지 그대로를 첨부해 이슈를 등록하세요.

전체 명령어