omm

omm link

설치된 모든 모델의 링크를 설치된 모든 러너에 대해 다시 확인하고 복구합니다 — 또는 omm이 직접 지원하지 않는 앱을 위해 허브 전체를 특정 디렉터리에 링크합니다.

01 / 06

개요

새 러너를 설치한 다음(그 전에 설치된 모델도 새 러너에 연결되도록), 또는 scan이 "설치된 엔진에 아직 링크되지 않음" 힌트를 보여줄 때 쓰는 명령입니다. 디렉터리 없이 실행하면 설치된 모든 모델을 설치된 모든 러너에 항상 다시 링크합니다 — 한 번도 안 걸린 것과 조용히 깨진 것 둘 다 포함하는데, 캐시된 linked 플래그를 절대 그대로 믿지 않기 때문입니다. 디렉터리를 주면, omm이 기본 지원하는 일곱 개가 아닌 앱을 위해 가능하면 복사 대신 중앙 파일을 직접 재사용합니다.

02 / 06

옵션

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

  • [directory]기본값: none — repairs known app links

    omm이 직접 지원하지 않는 앱을 위해, 설치된 모든 모델 파일을 링크할 추가 디렉터리.

  • --engineNAME기본값: every engine

    이 엔진 하나의 링크만 다시 확인·복구합니다.

  • --force기본값: off

    omm이 자기 것으로 인식하지 못하는 대상을 충돌로 건너뛰는 대신, 지우고 다시 링크해서 되찾습니다.

03 / 06

예제

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

설치된 모든 모델의 링크를 설치된 모든 러너에 대해 다시 확인·복구합니다.

$ omm link

Ollama 링크만 복구합니다.

$ omm link --engine ollama

지원하지 않는 앱을 위해 설치된 모든 모델을 디렉터리에 링크합니다.

$ omm link ~/my-runner/models

04 / 06

실제 실행 예시

2026-08-25, 실제로 실행한 omm link입니다: 임시 OMM_HOME 기준으로 작은 모델을 실제 설치하고, link를 실제로 실행해서 실제 Ollama 심볼릭 링크를 다시 썼고(link가 원래 하는 일 그대로), 캡처 직후 바로 제거했습니다 — 실제 ollama list에서도 제거된 걸 확인했습니다. "0 skipped (file missing)"은 실제 정확한 문구입니다 — 이전 버전 페이지가 실행해보지 않고 추측했던 "missing"이 아닙니다.

06 / 06

문제가 생겼다면

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

  1. --engine must be one of: anythingllm, jan, koboldcpp, lmstudio, mstystudio, ollama, textgenwebui (got 'bogus').
    원인
    --engine은 실제 존재하는 엔진 키만 받는데, 이번 실행에서는 다른 값을 줬습니다.
    대처
    메시지에 나열된 일곱 개 중 하나를 쓰세요.
    출처
    src/omm/cli.py:909-911
  2. --engine only applies without a directory argument.
    원인
    --engine은 복구할 러너 하나를 좁히는 옵션이고, 디렉터리 인자는 전혀 다른 뜻입니다 — 알려진 일곱 러너가 아닌 위치에 링크하겠다는 것. 둘은 같이 쓸 수 없습니다.
    대처
    러너 하나만 복구하려면 --engine만, 커스텀 위치에 링크하려면 디렉터리만 쓰세요.
    출처
    src/omm/cli.py:6501-6502

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

전체 명령어