Configuration Reference

Oh My OpenAgent는 강력한 의견을 가지고 있지만 취향에 맞게 조정할 수 있습니다. 대부분의 사용자는 설정할 필요가 없습니다. bunx oh-my-opencode install를 실행하고 바로 시작하세요.

Quick Start

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    "oracle": { "model": "openai/gpt-5.4", "variant": "high" },
    "explore": { "model": "github-copilot/grok-code-fast-1" }
  },
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },
    "visual-engineering": { "model": "google/gemini-3.1-pro" }
  }
}

Config File Locations

.opencode/oh-my-opencode.json (프로젝트 레벨)
~/.config/opencode/oh-my-opencode.json (사용자 레벨)

JSONC가 지원되어 주석과 후행 쉼표를 사용할 수 있습니다.

Agents

내장된 Agent의 특정 동작을 설정합니다: Sisyphus, Hephaestus, Oracle, Librarian, Explore, Multimodal Looker, Prometheus, Metis, Momus, Atlas, Frontend Engineer.

Override 옵션

Option	Type	Default	Description
model	string	-	모델 식별자 (예: openai/gpt-4o)
variant	string	-	모델 변형 (max, high, medium, low)
category	string	-	카테고리에서 설정 상속
temperature	number	-	샘플링 온도 (0-2)
top_p	number	-	Top-p 샘플링 (0-1)
prompt	string	-	시스템 프롬프트 완전히 재정의
prompt_append	string	-	시스템 프롬프트에 텍스트 추가
tools	Record	-	특정 도구 활성화 또는 비활성화
disable	boolean	false	이 Agent 비활성화
maxTokens	number	-	응답의 최대 토큰 수
thinking	object	-	확장 사고 설정
reasoningEffort	string	-	추론 노력: low, medium, high, xhigh

Permissions

Permission	Values	Description
edit	ask / allow / deny	파일 편집 기능
bash	ask / allow / deny	Bash 명령어 실행
webfetch	ask / allow / deny	웹 요청 기능
doom_loop	ask / allow / deny	무한 루프 재정의
external_directory	ask / allow / deny	프로젝트 외부 파일 접근

Skills

내장된 스킬에는 playwright, agent-browser, git-master가 포함됩니다. 커스텀 스킬도 정의할 수 있습니다.

"skills": {
  "my-custom-skill": {
    "description": "A custom skill for specific tasks",
    "instructions": "Always use this skill when..."
  }
}

Background Tasks

Option	Type	Default	Description
defaultConcurrency	number	-	기본 최대 동시 작업 수
staleTimeoutMs	number	-	오래된 작업 타임아웃 (ms)
providerConcurrency	number	-	프로바이더당 동시성 제한
modelConcurrency	number	-	모델당 동시성 제한

우선순위:modelConcurrency >providerConcurrency >defaultConcurrency

Hooks

Hooks를 사용하면 다양한 라이프사이클 지점에서 기능을 확장할 수 있습니다.

agent-usage-reminder

anthropic-context-window-limit-recovery

anthropic-effort

atlas

auto-slash-command

auto-update-checker

background-notification

category-skill-reminder

claude-code-hooks

comment-checker

compaction-context-injector

compaction-todo-preserver

delegate-task-retry

directory-agents-injector

directory-readme-injector

edit-error-recovery

interactive-bash-session

keyword-detector

non-interactive-env

prometheus-md-only

question-label-truncator

ralph-loop

rules-injector

session-recovery

sisyphus-junior-notepad

start-work

stop-continuation-guard

subagent-question-blocker

task-reminder

task-resume-info

tasks-todowrite-disabler

think-mode

thinking-block-validator

unstable-agent-babysitter

write-existing-file-guard

MCPs

websearch

Exa로 구동되는 고품질 검색 결과.

context7

문서 검색 및 컨텍스트 관리.

grep_app

GitHub 코드 검색 통합.

Browser Automation

Tool	Description	Use Case
playwright	풀 브라우저 자동화 (기본값)	테스트, 복잡한 상호작용
agent-browser	가벼운 브라우저 Agent	빠른 조회, 간단한 스크래핑

Tmux Integration

Option	Type	Default	Description
enabled	boolean	-	Tmux 통합 활성화
layout	string	-	Tmux 창 레이아웃
main_pane_size	string	-	메인 창 크기

Git Master

Option	Type	Default	Description
commit_footer	string	-	커밋 메시지에 추가할 텍스트
include_co_authored_by	boolean	-	Co-authored-by 트레일러 추가

Comment Checker

코드의 주석을 검증합니다. 커스텀 프롬프트에서 {{comments}} 자리 표시자를 사용하세요.

"comment-checker": {
  "custom_prompt": "Review these comments: {{comments}}"
}

Experimental Features

Option	Type	Default	Description
aggressive_truncation	boolean	-	출력을 적극적으로 잘라내기
auto_resume	boolean	-	중단된 작업 자동 재개
preemptive_compaction	boolean	-	제한 전 컨텍스트 압축
truncate_all_tool_outputs	boolean	-	모든 도구 출력 잘라내기

LSP Configuration

Option	Type	Default	Description
command	string	-	LSP 서버 명령어
extensions	array	-	매칭할 파일 확장자
priority	number	-	서버 우선순위
env	object	-	환경 변수
initialization	object	-	초기화 옵션
disabled	boolean	-	이 LSP 비활성화

Environment Variables

OPENCODE_CONFIG_DIR

기본 설정 디렉토리 경로를 재정의합니다.

Category	Default Model	Description
visual-engineering	gemini-3.1-pro (high)	프론트엔드, UI/UX, 디자인 작업
ultrabrain	gpt-5.3-codex (xhigh)	심층 논리적 추론
deep	gpt-5.3-codex (medium)	자율 문제 해결, 철저한 리서치
artistry	gemini-3.1-pro (high)	창의적 작업
quick	claude-haiku-4-5	간단하고 빠른 작업
unspecified-low	claude-sonnet-4-6	저노력 일반 작업
unspecified-high	gpt-5.4 (high)	고노력 일반 작업
writing	gemini-3-flash	문서 및 산문