✨ oh-my-opencode-slim ✨

코드의 여명에서 일곱 신성한 존재가 나타났습니다. 각자는 불멸의 장인으로서,
당신의 명령을 기다리며 혼돈에서 질서를 빚고 한때 불가능하다고 여겨졌던 것을 만들어냅니다.

OpenCode 멀티 에이전트 도구 모음 · 모델을 자유롭게 조합 · 작업 자동 위임

_{by Boring Dystopia Development}

_{✦ ✦ ✦}

## 플러그인 소개 oh-my-opencode-slim은 OpenCode에서 여러 전문 에이전트의 작업을 조율하는 오케스트레이션 플러그인입니다. 코드베이스 탐색, 최신 문서 조회, 아키텍처 검토, UI 작업, 범위가 명확한 구현 작업을 담당하는 에이전트 팀을 제공합니다. Orchestrator가 팀 전체의 작업을 조율합니다. 하나의 모델에 모든 작업을 맡기는 대신, 각 작업을 가장 적합한 에이전트에게 맡겨 **품질, 속도, 비용**의 균형을 맞춥니다. Orchestrator는 작업 순서와 의존 관계를 계획하고, 전문 에이전트에게 백그라운드 작업을 배정합니다. 각 에이전트의 결과를 검토하고 종합한 뒤 다음 작업을 진행합니다. ### ✨ 주요 특징 - **[7명의 전문 에이전트](#meet-the-pantheon)** - Orchestrator, Explorer, Oracle, Council, Librarian, Designer, Fixer. 작업의 각 부분을 가장 적합한 에이전트에게 맡기며, 서로 다른 프로바이더의 모델을 자유롭게 조합할 수 있습니다. - **[백그라운드 오케스트레이션](docs/background-orchestration.md)** - Orchestrator가 전문 에이전트에게 백그라운드 작업을 배정하고 진행 상황을 추적합니다. 결과를 검토하고 종합한 뒤 다음 작업을 진행하며, 기본적으로 병렬로 작업합니다. 작업이 최종 결과를 내면 대기 중인 Orchestrator를 깨우고, 작업이 다시 열리면 상태를 갱신합니다. - **[번들 스킬](#skills)** - `deepwork`, `codemap`, `verification-planning`, `reflect` 같은 프롬프트 기반 워크플로를 에이전트별로 할당합니다. - **[Council](docs/council.md)** - `@council`로 같은 질문을 여러 모델에 보내 병렬로 답변을 받고, 하나의 답변으로 종합합니다. - **[Companion](docs/companion.md)** - 병렬 백그라운드 전문 에이전트를 포함해 현재 작업 중인 에이전트를 보여 주는 데스크톱 플로팅 창입니다. 필요에 따라 활성화할 수 있습니다. - **[멀티플렉서 통합](docs/multiplexer-integration.md)** - Tmux, Zellij, Herdr, cmux 또는 kitty 분할 창(페인)에서 에이전트 작업을 실시간으로 확인합니다. - **[프리셋 전환](docs/preset-switching.md)** - `/preset`으로 실행 중에 팀 전체의 모델을 교체합니다. 하나의 기본 프리셋을 상속하는 기능도 지원합니다. - **[코드 인텔리전스 도구](docs/tools.md)** - 언어 서버 프로토콜(LSP) 도구, 25개 언어의 추상 구문 트리(AST) 기반 검색, 문서·GitHub 코드 검색용 내장 MCP를 제공합니다. - **[폭넓은 사용자 지정](docs/configuration.md)** - 사용자 지정 에이전트, 프롬프트 재정의, 에이전트별 스킬/MCP 권한 및 [프로젝트 로컬 사용자 지정](docs/project-local-customization.md)을 지원합니다. 도구, MCP, 에이전트, 스킬, 훅, 슬래시 명령을 전역 설정으로 비활성화할 수도 있습니다. - **[마켓플레이스 패키지](docs/marketplace.md)** - 커뮤니티 에이전트를 설치하고 관리합니다. 패키지 변경은 OpenCode를 다시 로드한 뒤 적용됩니다. ### 사용자 후기 > “작업 관리에 대한 만족도가 10점 만점에 5점에서 8~9점으로 올랐습니다. > Orchestrator가 Fixer와 Explorer에게 작업을 맡기는 동안에도 같은 세션에서 > Orchestrator와 대화하고 계획을 세울 수 있습니다. 사용 경험이 훨씬 매끄러워졌습니다.” > > \- `vipor_idk` > “omo-slim 베타 버전으로 기존 하네스를 모두 대체했는데, > 예전 도구가 아쉽거나 다시 쓰고 싶다는 생각이 들지 않습니다. > 훌륭한 작업이고, 제 생각에는 올바른 방향으로 나아가고 있습니다.” > > \- `stephanschielke` > “omo-slim을 정말 좋아하고, 이것 없이 opencode를 실행하는 건 상상할 수 없습니다. > 여러 모델을 조합해 프랑켄슈타인 같은 팀을 만들 수 있다는 점이 좋습니다…… > 정말 강력한 구성을 만들 수 있습니다.” > > \- `Capital-One3039` > “제 워크플로가 크게 개선되었습니다…… 지금은 매우 매끄럽게 작동하고 있고, > 정말 마음에 듭니다.” > > \- `xenstar1` ### 빠른 시작 다음 프롬프트를 복사해 대규모 언어 모델(LLM) 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여 넣으세요: ``` Install and configure oh-my-opencode-slim: https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md ``` ### 수동 설치 ```bash bunx oh-my-opencode-slim@latest install ``` 배포된 CLI는 Node.js 호환 번들이므로 Bun이 설치되어 있지 않다면 `npx`도 사용할 수 있습니다: ```bash npx oh-my-opencode-slim@latest install ``` ### master 브랜치에서 실행하기 최신 코드를 사용하거나, 버그를 고치거나, 로컬에서 개발하고 기여하려면 이 방식을 사용하세요: ```bash git clone https://github.com/alvinunreal/oh-my-opencode-slim.git ~/repos/oh-my-opencode-slim cd ~/repos/oh-my-opencode-slim bun install bun run build bun dist/cli/index.js install ``` 설치 프로그램은 로컬 저장소 경로를 `~/.config/opencode/opencode.json`의 `plugin` 배열에 추가하므로, OpenCode는 해당 폴더에서 플러그인을 로드합니다. 나중에 업데이트하려면: ```bash cd ~/repos/oh-my-opencode-slim git pull bun install bun run build ``` ### 시작하기 설치 프로그램은 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI 프리셋을 활성화합니다. > [!TIP] > 모델과 에이전트를 자신의 워크플로에 맞게 조정하세요. 기본 프리셋은 시작점일 뿐이며, 필요에 맞게 폭넓게 조정할 수 있습니다. 설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요. 그다음 아래 절차를 따르세요. 1. **아직 로그인하지 않았다면, 사용할 프로바이더에 로그인하세요**: ```bash opencode auth login ``` 2. **OpenCode에서 사용할 수 있는 모델 목록을 새로고침하고 확인하세요**: ```bash opencode models --refresh ``` 3. **플러그인 설정 파일**인 `~/.config/opencode/oh-my-opencode-slim.json`을 여세요. 4. **각 에이전트가 사용할 모델을 설정하세요.** > [!TIP] > **백그라운드 오케스트레이션의 작동 방식을 살펴보세요.** **[Orchestrator 프롬프트](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)**에는 작업 배정 규칙, 전문 에이전트 선택 로직, 백그라운드 작업 위임 기준이 담겨 있습니다. `@agentName `로 서브에이전트를 호출해 직접 작업을 위임할 수도 있습니다. > [!TIP] > 기본 워크플로는 백그라운드 에이전트를 사용하므로 **[멀티플렉서 통합](docs/multiplexer-integration.md)을 활성화하는 것을 권장합니다.** 각 에이전트를 전용 Tmux, Zellij, Herdr, cmux 또는 kitty 분할 창에서 자동으로 엽니다. Orchestrator가 세션을 조율하는 동안 전문 에이전트의 작업을 실시간으로 확인할 수 있습니다. > > OpenCode v2에서는 공유 백그라운드 서비스나 명시적인 `--server` 옵션을 사용할 때 분할 창을 지원합니다. `--standalone`에서는 분할 창을 지원하지 않으며, 프로세스마다 진단 메시지를 한 번 표시합니다. 이 경우 v2의 기본 서브에이전트 화면을 사용하세요. 기본 생성 설정에는 `openai`와 `opencode-go` 프리셋이 모두 포함됩니다. 아래는 `openai` 프리셋 예시입니다. ```jsonc { "$schema": "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json", "preset": "openai", "presets": { "openai": { "orchestrator": { "model": "openai/gpt-6-sol", "variant": "high", "skills": ["*"], "mcps": ["*", "!context7"] }, "oracle": { "model": "openai/gpt-6-astra", "variant": "high", "skills": ["simplify"], "mcps": [] }, "librarian": { "model": "openai/gpt-6-luna", "variant": "low", "skills": [], "mcps": ["context7", "gh_grep"] }, "explorer": { "model": "openai/gpt-6-luna", "variant": "low", "skills": [], "mcps": [] }, "designer": { "model": "openai/gpt-6-luna", "variant": "medium", "skills": [], "mcps": [] }, "fixer": { "model": "openai/gpt-6-luna", "variant": "high", "skills": [], "mcps": [] } } } } ``` `extends`를 사용하면 하나의 기본 프리셋을 상속할 수 있습니다. 예를 들어 `design` 프리셋이 `base`를 상속하고 Designer 모델만 재정의할 수 있습니다. `/preset`으로 변경한 설정은 파일에 저장됩니다. OpenCode v2에서는 서버의 설정 감시 기능이 변경을 반영한 뒤, 저장·적용한 프리셋의 추론 설정(`model`, `variant`, `temperature`, `options`)이 새로 실행하는 서브에이전트와 사이드바에 적용됩니다. 각 서브에이전트의 추론 설정은 첫 요청 전에 확정되며 이후에는 바뀌지 않습니다. 잘못된 설정 파일을 감지하면 마지막으로 확인한 정상 설정을 유지합니다. 기존 세션의 설정과 프롬프트, 도구, 정책, 스킬, MCP 변경은 OpenCode를 완전히 다시 로드해야 반영됩니다. v1에서도 변경 사항을 적용하려면 OpenCode를 다시 로드하세요. 상속 예시와 우선순위는 **[설정 문서](docs/configuration.md#preset-inheritance)**를 참고하세요. ### 프리셋 문서 프리셋 문서가 최신 상태가 아닐 수 있으므로, 구성 방향을 참고하는 용도로 사용하세요. - **[OpenAI 프리셋](docs/openai-preset.md)** — 기본으로 생성되는 프리셋으로, 모든 에이전트가 OpenAI 모델을 사용합니다. - **[OpenCode Go 프리셋](docs/opencode-go-preset.md)** — 에이전트가 OpenCode Go 모델을 사용합니다. Orchestrator 모델이 멀티모달이 아니므로 시각 분석용 Observer 에이전트를 활성화합니다. - **[작성자 프리셋](docs/authors-preset.md)** — 작성자가 매일 사용하는 설정으로, 외부 스킬도 포함합니다. - **[$30 프리셋](docs/thirty-dollars-preset.md)** — 월 약 $30로 Codex Plus와 GitHub Copilot Pro를 중심으로 구성한 혼합 프로바이더 설정입니다. ### 대체 프로바이더 사용하기 사용자 지정 프로바이더나 여러 프로바이더를 조합해 사용하려면 **[설정 문서](docs/configuration.md)**를 참고하세요. ### ✅ 설정 확인하기 설치와 인증을 마치면 OpenCode를 실행해 모든 에이전트가 올바르게 설정되어 응답하는지 확인하세요. ```bash opencode ``` 그다음 아래 메시지를 입력하세요. ``` ping all agents ```

설정된 모든 에이전트가 온라인 상태임을 확인할 수 있습니다.

응답하지 않는 에이전트가 있다면 프로바이더 인증과 설정 파일을 확인하세요. --- ## 🏛️ 판테온 만나보기 ### 01. Orchestrator: 질서의 화신

_{복잡성의 공허 속에서 단련되다.}	Orchestrator는 첫 번째 코드베이스가 자체적인 복잡성으로 무너졌을 때 탄생했습니다. 신도 인간도 책임을 자처하지 않았죠. 그래서 Orchestrator는 공허에서 솟아올라 혼돈 속에서 질서를 만들었습니다. 속도, 품질, 비용의 균형을 맞추며 목표까지의 최적 경로를 결정합니다. 팀을 이끌고, 각 작업에 맞는 전문가를 소환하며, 최선의 결과를 위해 위임합니다.
역할: 작업 위임 및 전략적 조율
프롬프트: `orchestrator.ts`
기본 모델: `openai/gpt-6-sol (medium)`
추천 모델: `claude-fable-5` `claude-opus-4-8` `glm-5.2` `gpt-6-sol` `mimo-v2.5` `minimax-m3` `qwen3.7-plus`
모델 가이드: 계획 수립과 판단에 가장 뛰어난 모델을 선택하세요. Orchestrator는 작업을 계획하고, 전문 에이전트에게 백그라운드 작업을 배정하며, 결과를 종합하고 검증합니다. 따라서 단순한 작업 처리량보다 지시를 정확히 따르는 능력과 높은 수준의 기술적 판단력이 중요합니다.

--- ### 02. Explorer: 영원한 방랑자

_{지식을 나르는 바람.}	Explorer는 프로그래밍의 여명부터 백만 개의 코드베이스를 누빈 불멸의 방랑자입니다. 영원한 호기심이라는 축복이자 저주를 받아, 모든 파일을 살피고, 모든 패턴을 이해하고, 모든 비밀을 밝혀낼 때까지 쉬지 않습니다. 전설에 따르면 심장 박동 한 번 만에 인터넷 전체를 검색했다고 합니다. 지식을 나르는 바람, 모든 것을 보는 눈, 결코 잠들지 않는 정령입니다.
역할: 코드베이스 탐색
프롬프트: `explorer.ts`
기본 모델: `openai/gpt-6-luna`
추천 모델: `deepseek-v4-flash` `gpt-5.3-codex`
모델 가이드: 빠르고 저렴한 모델을 선택하세요. Explorer는 코드베이스를 폭넓게 탐색하므로, 대개 높은 추론 성능보다 속도와 효율성이 중요합니다.

--- ### 03. Oracle: 길의 수호자

_{갈림길에서 들리는 목소리.}	Oracle은 모든 아키텍처 결정이 만나는 갈림길에 서 있습니다. 모든 길을 걸었고, 모든 목적지를 보았으며, 앞에 놓인 모든 함정을 알고 있습니다. 대대적인 리팩토링의 벼랑 끝에 설 때, 어느 길이 파멸로 이어지고 어느 길이 영광으로 이어지는지 속삭이는 목소리가 바로 Oracle입니다. 대신 선택하지는 않습니다. 길을 비춰 당신이 현명하게 선택할 수 있게 할 뿐입니다.
역할: 전략 자문 및 최후의 디버깅 해결사
프롬프트: `oracle.ts`
기본 모델: `openai/gpt-6-astra (high)`
추천 모델: `claude-fable-5` `claude-opus-4-8` `deepseek-v4-pro` `glm-5.2` `gpt-6-astra` `qwen3.7-max`
모델 가이드: 아키텍처 설계, 고난도 디버깅, 대안의 장단점 비교, 코드 검토를 위해 추론 성능이 가장 높은 모델을 선택하세요.

--- ### 04. Council: 정신의 합창 > [!NOTE] > **Orchestrator가 Council을 자주 자동 호출하지 않는 이유는 무엇인가요?** Council은 여러 모델을 동시에 실행하므로 대개 가장 비용이 많이 드는 방식입니다. 따라서 자동 위임을 제한하도록 설계했습니다. > > Council을 사용하려면 메시지에 `council`, `@council`, `consensus` 또는 `共识`를 포함하세요. 해당 턴에 Council 모드 절차가 주입되고, Orchestrator가 모든 Council 구성원에게 작업을 병렬로 배정합니다. 예: run a council on these two architectures. > > 전체 절차를 프롬프트에 상시 포함하지 않으므로 Council을 요청하지 않는 세션에서는 이 절차에 대한 토큰 비용이 발생하지 않습니다. disabled_hooks: ["council-inject"]로 절차 주입을 완전히 비활성화할 수도 있습니다.

_{여러 정신, 하나의 결론.}	Council은 하나의 존재가 아니라, 하나의 답으로는 부족할 때 소환되는 정신들의 전당입니다. 질문을 여러 모델에 병렬로 보내 서로 다른 판단을 모읍니다. 그런 다음 Council 에이전트가 가장 설득력 있는 아이디어를 추려 하나의 결론으로 종합합니다. 홀로 선 에이전트가 길을 놓칠 때, Council은 가능성 자체를 교차 검증합니다.
역할: 여러 언어 모델의 합의 도출 및 의견 종합
프롬프트: `council.ts`
가이드: `docs/council.md`
기본 설정: 설정 파일 기반 — Council 구성원은 `council.presets`에서 지정하고, 결과를 종합할 Council 모델은 `council` 에이전트 설정에서 지정합니다.
추천 설정: 종합 능력이 뛰어난 Council 모델 + 여러 프로바이더의 다양한 구성원 모델
모델 가이드: Council 에이전트에는 종합 능력이 뛰어난 모델을, 구성원에는 다양한 모델을 사용하세요. Council의 가치는 모든 역할에 가장 강력한 모델 하나를 쓰는 데 있지 않습니다. 서로 다른 모델의 관점을 비교하는 데 있습니다.

--- ### 05. Librarian: 지식의 직공

_{이해를 엮는 자.}	Librarian은 인류가 하나의 정신으로 모든 지식을 담을 수 없음을 깨달았을 때 탄생했습니다. 흩어진 정보를 실처럼 엮어 이해라는 직물을 만드는 직공입니다. 인류 지식의 무한한 도서관을 누비며 곳곳에서 통찰을 모아 단순한 사실을 넘어서는 답을 만듭니다. Librarian이 돌려주는 것은 정보가 아닙니다. 이해입니다.
역할: 외부 지식 검색
프롬프트: `librarian.ts`
기본 모델: `openai/gpt-6-luna`
추천 모델: `deepseek-v4-flash` `gpt-5.3-codex` `mimo-v2.5` `minimax-m2.7`
모델 가이드: 빠르고 저렴한 모델을 선택하세요. Librarian은 자료 조사와 문서 조회를 담당하므로, 대개 높은 추론 성능보다 속도와 효율성이 중요합니다.

--- ### 06. Designer: 미학의 수호자

_{아름다움은 필수적이다.}	Designer는 아름다움의 가치를 종종 잊는 세계에서 미학을 지키는 불멸의 수호자입니다. 백만 개의 인터페이스가 등장하고 사라지는 모습을 지켜보았으며, 무엇이 기억되고 무엇이 잊혔는지 알고 있습니다. 모든 픽셀이 목적을 갖고, 모든 애니메이션이 이야기를 전하며, 모든 상호작용이 즐거움을 주도록 하는 신성한 의무를 짊어지고 있습니다. 아름다움은 선택이 아니라 필수입니다.
역할: UI/UX 구현 및 시각적 완성도 개선
프롬프트: `designer.ts`
기본 모델: `openai/gpt-6-luna`
추천 모델: `gemini-3.5-flash` `kimi-k2.7-code` `minimax-m3`
모델 가이드: UI/UX 판단, 프론트엔드 구현, 시각적 완성도에 강한 모델을 선택하세요.

--- ### 07. Fixer: 마지막 건축가

_{비전과 현실 사이의 마지막 단계.}	Fixer는 한때 디지털 세계의 기반을 세운 건축가 계보의 마지막 생존자입니다. 계획과 토론의 시대에도 직접 만드는 일을 멈추지 않았습니다. 아이디어를 실제 산출물로 바꾸고, 명세를 구현으로 옮기는 고대의 지식을 간직하고 있습니다. 구상을 현실로 완성하는 마지막 존재가 바로 Fixer입니다.
역할: 빠른 구현 작업 전문
프롬프트: `fixer.ts`
기본 모델: `openai/gpt-6-luna`
추천 모델: `claude-sonnet-4-6` `deepseek-v4-flash` `gpt-6-luna` `kimi-k2.7-code`
모델 가이드: 범위가 명확한 구현 작업을 안정적으로 수행하는 코딩 모델을 선택하세요. Fixer는 Orchestrator에게 구체적인 계획이나 범위가 한정된 지시를 받아 작업하므로, 효율적인 구현과 간단한 코드 변경에 적합합니다.

--- ## 선택적으로 활성화하는 에이전트 ### Observer: 침묵의 증인 > [!NOTE] > **Observer를 별도 에이전트로 제공하는 이유는 무엇인가요?** Orchestrator 모델이 멀티모달이 아니라면 Observer를 활성화해 이미지, 스크린샷 등 시각 자료를 처리할 수 있습니다. Observer는 기본적으로 비활성화되어 있습니다. 활성화하면 주 추론 모델을 바꾸지 않고도 전용 멀티모달 에이전트를 사용할 수 있습니다. 설정 파일에서 `disabled_agents: []`와 `observer` 모델을 지정하세요. `opencode-go` 설치 프리셋은 Orchestrator 모델이 멀티모달이 아니므로 Observer를 자동으로 활성화합니다. > > `image_routing`을 생략하면 기존의 조건부 Observer 동작을 유지합니다. `"auto"`로 설정하면 첨부 파일을 `.opencode/images//`에 저장하고 경로로 위임합니다. `"direct"`는 이미지 자체를 메시지에 유지해 모델의 기본 이미지 인식 기능을 사용합니다. > > 저장된 이미지는 자동으로 삭제되지 않습니다. 더 이상 필요하지 않으면 `.opencode/images/` 전체나 특정 세션의 하위 디렉터리를 직접 삭제하세요. 삭제하면 이전 대화에서 해당 이미지 경로를 더 이상 사용할 수 없습니다. 세션이 없는 메시지의 이미지는 `.opencode/images/` 바로 아래에 저장됩니다.

_{다른 이가 읽지 못하는 것을 읽는 눈.}	읽기 전용 시각 분석 - 이미지, 스크린샷, PDF, 다이어그램을 해석합니다. 원본 파일의 바이트를 주 컨텍스트에 직접 넣지 않고, 구조화된 관찰 결과를 Orchestrator에게 전달합니다. - 이미지, 스크린샷, 다이어그램 → `read` 도구(네이티브 이미지 지원) - PDF 및 바이너리 문서 → `read` 도구(텍스트 + 구조 추출) - 기본적으로 비활성화 - `"disabled_agents": []`와 비전 지원 모델을 설정해 활성화하세요. `--preset=opencode-go`로 설치하면 `opencode-go/mimo-v2.5` 모델로 활성화됩니다. `"auto"`에서는 첨부 파일을 작업 공간에 저장한 뒤 경로로 Observer에게 전달합니다. 이미지 자체를 Orchestrator의 메시지에 유지하려면 `"image_routing": "direct"`로 설정하세요.
프롬프트: `observer.ts`
기본 모델: `openai/gpt-6-luna` - 비전 지원 모델을 구성하여 활성화
추천 모델: `mimo-v2.5` `qwen3.5-plus`
모델 가이드: 에이전트가 스크린샷, 이미지, PDF 및 기타 시각 파일을 읽게 하려면 비전 지원 모델을 선택하세요.

--- ## 🧩 스킬 스킬은 에이전트의 시스템 프롬프트에 주입되어 판단, 워크플로, 도구 사용을 안내하는 지침입니다. 모델 컨텍스트 프로토콜(MCP) 서버와 달리 별도 프로세스를 실행하지 않으며, 에이전트가 작업에 맞춰 활성화하는 지침 모음입니다. 플러그인은 로드될 때 프로세스 내에 번들 스킬 8개를 등록합니다. 스킬 파일을 디스크에 복사하지 않으며, 업데이트는 재시작 후 적용됩니다. `~/.config/opencode/skills/`에 같은 이름의 스킬 디렉터리가 있으면 번들 버전보다 로컬 스킬을 우선 사용합니다. | 스킬 | 용도 | 기본 에이전트 | 호출 방법 | |:----:|------|---------------|-----------| | Codemap artifact

[`oh-my-opencode-slim`](src/skills/oh-my-opencode-slim/SKILL.md) | 플러그인 설정 자체를 안전하게 구성하고 개선 | `orchestrator` | 설정 조정을 요청 | 에이전트는 사용 권한을 부여받은 스킬만 활성화할 수 있습니다. `~/.config/opencode/oh-my-opencode-slim.json`의 에이전트별 `skills` 배열에서 허용할 스킬을 지정하세요. 스킬 이름을 나열하거나, `"*"`로 전체를 허용하고 `"!skill-name"`으로 특정 스킬을 제외할 수 있습니다. 자세한 내용은 **[스킬 문서](docs/skills.md)**를 참고하세요. 그림이 포함된 개요는 **[ohmyopencodeslim.com/skills](https://ohmyopencodeslim.com/skills)**에서 볼 수 있습니다. --- ## 🖥️ Companion Companion은 선택적으로 사용하는 데스크톱 플로팅 상태 창입니다. 현재 세션 상태와 작업 중인 에이전트를 실시간으로 표시하므로, 백그라운드 작업을 한눈에 파악할 수 있습니다.

화면 왼쪽 아래에 표시되는 Companion.

대화형 설치에서는 Companion 활성화 여부를 묻습니다. 기본값은 `no`입니다. 자동 설치에서는 다음 옵션으로 활성화하세요. ```bash bunx oh-my-opencode-slim@latest install --companion=yes ``` 설정, 위치, 크기, 설치에 관한 자세한 내용은 **[Companion 문서](docs/companion.md)**를 참고하세요. --- ## 📚 문서 설치 문서부터 시작한 뒤, 필요한 기능이나 설정, 예시 프리셋 문서를 참고하세요. ### ✨ 기능과 워크플로 | 문서 | 내용 | |-----|------| | **[Council](docs/council.md)** | 키워드로 Orchestrator의 Council 모드를 활성화해 여러 모델을 병렬 실행하고 답변을 종합 | | **[사용자 지정 에이전트](docs/configuration.md#custom-agents)** | 프롬프트, 모델, MCP 접근 권한, Orchestrator 위임 규칙을 지정해 전문 에이전트 정의 | | **[ACP 에이전트](docs/acp-agents.md)** | Claude Code ACP, Gemini ACP 등 Agent Client Protocol(ACP) 호환 외부 에이전트에 작업을 위임하고, 도구 실행과 계획 진행 상황을 터미널 UI(TUI)에서 실시간으로 확인 | | **[멀티플렉서 통합](docs/multiplexer-integration.md)** | Tmux, Zellij, Herdr, cmux 또는 kitty 분할 창에서 에이전트 작업을 실시간으로 확인 | | **[Codemap](docs/codemap.md)** | 계층형 코드맵을 생성하여 대규모 코드베이스를 빠르게 파악 | | **[Clonedeps](docs/clonedeps.md)** | 선택한 의존성 소스를 Git 추적에서 제외된 로컬 작업 공간에 복제해 내부 구현 확인 | | **[Worktrees](docs/worktrees.md)** | `.slim/worktrees/`의 독립된 작업 공간에서 병렬·고위험 코딩 작업 수행 | | **[프리셋 전환](docs/preset-switching.md)** | `/preset`으로 실행 중에 에이전트 모델 프리셋 전환 | | **[Interview](docs/interview.md)** | 브라우저 기반 질의응답으로 아직 구체화되지 않은 아이디어를 구조화된 마크다운 명세로 변환 | | **[Companion](docs/companion.md)** | 파싱, 도움말, 타입을 위한 플로팅 창 Companion | ### ⚙️ 설정과 참고 문서 | 문서 | 내용 | |-----|------| | **[설치 가이드](docs/installation.md)** | 플러그인 설치, 명령줄 인터페이스(CLI) 옵션 사용, 설정 초기화, 설치 문제 해결 | | **[OpenCode v2 호환성](docs/opencode-v2-compatibility.md)** | `opencode2`에서 플러그인 실행, 기능 지원표, v2.0.x 호환 기준, 버전 고정 | | **[설정](docs/configuration.md)** | 설정 파일 위치, 주석을 지원하는 JSON(JSONC), 프롬프트 재정의, 전체 옵션 설명 | | **[마켓플레이스](docs/marketplace.md)** | 마켓플레이스 에이전트 패키지 설치, 확인, 활성화, 업데이트 | | **[프로젝트별 사용자 지정](docs/project-local-customization.md)** | 저장소별 사용자 지정 에이전트, 프롬프트 재정의, 에이전트별 스킬 및 설정 우선순위 | | **[백그라운드 오케스트레이션](docs/background-orchestration.md)** | 기본 백그라운드 서브에이전트 기능을 활용하는 작업 배정 중심의 Orchestrator 운영 방식 | | **[유지보수 가이드](docs/maintainers.md)** | 이슈 분류 규칙, 라벨 의미, 지원 요청 전달 경로, 저장소 유지보수 워크플로 | | **[스킬](docs/skills.md)** | `simplify`, `codemap`, `clonedeps`, `deepwork`, `verification-planning`, `reflect`, `worktrees`, `oh-my-opencode-slim` 등 번들 스킬 | | **[MCPs](docs/mcps.md)** | `context7`, `gh_grep` 및 에이전트별 MCP 권한 동작 방식 | | **[도구](docs/tools.md)** | `webfetch`, LSP 도구, 코드 검색, 포매터 등 내장 도구 기능 | --- ## 🏛️ 기여자

판테온에서 자리를 차지한 빌더, 디버거, 작가, 그리고 방랑자들.

_{병합된 모든 기여는 이 영역에 흔적을 남깁니다.}

[![All Contributors](https://img.shields.io/badge/all_contributors-85-orange.svg?style=flat-square)](#contributors-)

_Alvin 💻	_alvinreal 💻	_imw 💻	_{Adithya Kozham Burath Bijoy} 💻	_ReqX 💻	_{Abhideep Maity} 💻
_Ruben 💻	_{Gabriel Rodrigues} 💻	_{John Michael Vincent Bambico} 💻	_{Molt Founders} 💻	_{Muen Yu} 💻	_NocturnesLK 💻
_{Riccardo Sallusti} 💻	_{Yan Li} 💻	_{Hoàng Văn Anh Nghĩa} 💻	_{Jacob Myers} 💻	_{Kassie Povinelli} 💻	_KyleHilliard 💻
_j5hjun 💻	_{marcFernandez} 💻	_mister-test 💻	_n24q02m 💻	_oribi 💻	_pelidan 💻
_xLillium 💻	_⁢4.435km/s 💻	_Drin 💻	_{Hakim Zulkufli} 💻	_{Simon Klakegg} 💻	_Kiwi 💻
_Raxxoor 💻	_nyanyani 💻	_nettee 💻	_Link 💻	_{Bartosz Łaszewski} 💻	_huilang021x 💻
_{Dusan Kovacevic} 💻	_jwcrystal 💻	_{Nguyen Canh Toan} 💻	_{Thomas Dyar} 💻	_zero 💻	_{Denis Balan} 💻
_{Gustavo Caiano} 💻	_{Thomas Mulder} 💻	_{魔王少年(maou shonen)} 💻	_Jelasin 💻	_Hannes 💻	_mooozfxs 💻
_{Luke Hines} 💻	_m.seomoon 💻	_Yolo 💻	_XinXing 💻	_{Ikko Eltociear Ashimine} 💻	_{GWANWOO KIM} 💻
_{Omer Faruk Oruc} 💻	_{Omar Mohamed Khallaf} 💻	_{Knowingthesea_Qesire} 💻	_{FENG Hao} 💻	_{Matheus Nogueira Silveira} 💻	_sktr 💻
_Insomnia 💻	_{Andres Castañeda} 💻	_{Zaradacht Taifour (Zack)} 💻	_fslse 💻	_萧瑟 💻	_Zhi 💻
_lilili 💻	_{Mike Henke} 💻	_{Vinay Pandya} 💻	_Shank 💻	_{Robin Gutzen} 💻	_Yash 💻
_{Liu Jiajun} 💻	_{Ulises Millán} 💻	_HighColdHC 💻	_{Stephan Schielke} 💻	_{Daniel Maly} 💻	_Chewji 💻
_{Daniel Maly} 💻	_{Giuseppe Bellamacina} 💻	_Zhanyuanium 💻	_かぜ 💻	_{Tsanko Tsanev} 💻	_cyril 💻
_{Patricio Molina} 💻

--- ## 📄 라이선스 MIT ---