🔷 07. CLI 가이드

CLI를 자주 쓰는 순서로 재구성한 실전 레퍼런스입니다. 설치/진단/실행/인증을 빠르게 처리할 수 있습니다.

빠르게 실행 (복붙)

bunx oh-my-opencode
bunx oh-my-opencode install
bunx oh-my-opencode doctor --verbose
bunx oh-my-opencode run "fix lint"
bunx oh-my-opencode auth status
bunx oh-my-opencode mcp oauth status

flowchart LR
A[install] --> B[doctor]
B --> C[run]
C --> D[auth]
D --> E[mcp oauth]

단계별 적용

1) install로 초기 세팅

• 설명: 초기 설치/플러그인 등록은 install로 시작합니다.
• 실행 예시: bunx oh-my-opencode

2) doctor로 진단

• 설명: 환경/인증/의존성 문제는 doctor로 먼저 진단합니다.
• 실행 예시: bunx oh-my-opencode install

3) run으로 작업 실행

• 설명: 프롬프트 실행 시 timeout/enforce-completion 옵션을 상황에 맞게 사용합니다.
• 실행 예시: bunx oh-my-opencode doctor --verbose

4) auth/mcp oauth 관리

• 설명: 공급자 인증과 MCP OAuth 토큰 상태를 분리 관리합니다.
• 실행 예시: bunx oh-my-opencode run "fix lint"

5) CI 모드 적용

• 설명: 자동화 환경에서는 —no-tui —json 출력으로 파이프라인에 연결합니다.
• 실행 예시: bunx oh-my-opencode auth status

부록) 원문 코드 스니펫 (검수용, 초보자는 건너뛰기)

# Basic execution (displays help)
bunx oh-my-opencode
# Or run with npx
npx oh-my-opencode

bunx oh-my-opencode install

bunx oh-my-opencode doctor

bunx oh-my-opencode run [prompt]

# Login to an OAuth-protected MCP server
bunx oh-my-opencode mcp oauth login <server-name> --server-url https://api.example.com
# Login with explicit client ID and scopes
bunx oh-my-opencode mcp oauth login my-api --server-url https://api.example.com --client-id my-client --scopes "read,write"
# Remove stored OAuth tokens
bunx oh-my-opencode mcp oauth logout <server-name>
# Check OAuth token status
bunx oh-my-opencode mcp oauth status [server-name]

# Login
bunx oh-my-opencode auth login
# Logout
bunx oh-my-opencode auth logout
# Check current status
bunx oh-my-opencode auth status

{
  // Agent configuration
  "sisyphus_agent": {
    "disabled": false,
    "planner_enabled": true,
  },
  /* Category customization */
  "categories": {
    "visual-engineering": {
      "model": "google/gemini-3-pro",
    },
  },
}

# Update OpenCode
npm install -g opencode@latest
# or
bun install -g opencode@latest

마무리 체크

• 위 “빠르게 실행” 명령을 최소 1개 실행했다.
• 실패 시 “원문 실행 코드 확장”의 관련 코드를 사용해 재검증했다.
• 원본 항목 대조 인덱스에서 빠진 기능이 없는지 확인했다.

---

출처

• 원문(로컬): oh-my-opencode/docs/cli-guide.md
• 원문(GitHub): https://github.com/code-yeongyu/oh-my-opencode/blob/dev/docs/cli-guide.md