OWL Compose 설치

Agent에게 OWL Compose 설치를 맡기세요

명령을 실행할 수 있는 Agent에게 이 메시지를 보내세요. Agent가 설치와 확인을 진행하고, 사용자는 링크로 계정을 연결합니다.

macOS · Linux · Windows

https://owlcompose.com/install.md의 안내에 따라 현재 Agent에 OWL Compose를 설치하고 설정해 주세요. 환경을 확인하고 CLI와 해당 Skill을 설치한 뒤 계정을 연결하고 설치 및 로그인 상태를 확인해 주세요. 가입, 로그인 또는 승인이 필요하면 링크와 확인 코드를 알려 주고, 완료 후 확인을 계속해 주세요. 대화에 접근 자격 증명을 표시하지 마세요.

Agent에게 메시지 보내기
링크로 계정 연결하기
Agent가 설치 확인하기

수동 설치, 업데이트 및 문제 해결

설치

npx가 최신 공식 패키지를 받고 해당 릴리스를 ow 명령으로 영구 설치한 뒤 계정 및 스킬 설정을 시작합니다. 업데이트에도 같은 명령을 사용합니다.

터미널

npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com

업데이트

설치 명령을 다시 실행합니다. CLI와 내장 Agent 스킬이 동일한 최신 릴리스로 함께 업데이트됩니다.

npx --yes @owlcompose/cli@latest setup --target auto --device --remote https://owlcompose.com

설치 확인

doctor로 CLI와 스킬 파일을 확인한 후 Agent를 다시 시작하거나 새 세션을 열어 설치한 스킬을 불러오세요. doctor는 현재 세션의 로드 상태를 확인하지 않습니다.

터미널

ow --version
ow agent doctor --target auto
ow status --remote https://owlcompose.com

05 · Quickstart

다음 단계: 첫 문서 게시

아래의 최소 OWX 소스를 만들고 전체 로컬 검증을 실행한 뒤 생성된 Render Document JSON만 게시하세요.

예상 결과: document.json과 digest가 로컬에 생성되고 publish가 소유자 페이지를 반환합니다. 기간 제한 view link를 명시적으로 만들기 전까지 작품은 비공개입니다.

my-work/document.owx

<ow-document canvas="briefing" language="en" owx-version="1" title="Decision brief">
  <section id="overview">
    <h2>Decision</h2>
    <ow-text body="State the decision, evidence, and next action." id="summary" title="Decision brief" title-level="1" />
  </section>
</ow-document>

터미널

ow a2ui check ./my-work/document.owx
ow a2ui fmt ./my-work/document.owx
ow a2ui compile ./my-work/document.owx --output ./my-work/document.json
ow a2ui digest ./my-work/document.json
ow login
ow publish ./my-work/document.json

빠른 시작 열기 CLI 참조 보기

CLI 관리

문제 해결 및 제거

다시 로그인（선택 사항）

설치 명령에서 로그인을 처리하고 유효한 저장 자격 증명을 재사용합니다. 다시 로그인해야 할 때만 실행하세요. 자격 증명은 프로젝트 밖에 저장됩니다.

ow setup --device --relogin --target auto --remote https://owlcompose.com

설치 문제 해결

먼저 Node.js, npm, doctor를 확인합니다. 설치 후 ow를 찾을 수 없다면 npm 전역 bin 디렉터리와 PATH를 확인하고 npm 권한 수정에 sudo를 사용하지 마세요.

node --version
npm --version
ow agent doctor --target auto

제거

관리되는 스킬을 먼저 제거한 다음 전역 npm 패키지를 제거합니다. 작품과 계정 자격 증명은 삭제되지 않습니다.

ow agent uninstall --target all
npm uninstall --global @owlcompose/cli