Skip to content

Commit 41d3817

Browse files
code-yeongyucode-yeongyu
committed
docs: reorganize Configuration section to bottom, add LSP config docs
1 parent a119429 commit 41d3817

File tree

2 files changed

+164
-121
lines changed

2 files changed

+164
-121
lines changed

‎README.ko.md‎

Lines changed: 82 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,6 @@
55
- [Oh My OpenCode](#oh-my-opencode)
66
- [세 줄 요약](#세-줄-요약)
77
- [설치](#설치)
8-
- [설정](#설정)
9-
- [특정 MCP 비활성화](#특정-mcp-비활성화)
10-
- [특정 Agent 비활성화](#특정-agent-비활성화)
11-
- [Agent 설정](#agent-설정)
128
- [LLM Agent를 위한 안내](#llm-agent를-위한-안내)
139
- [Why OpenCode & Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
1410
- [기능](#기능)
@@ -20,6 +16,7 @@
2016
- [Safe Grep](#safe-grep)
2117
- [내장 MCPs](#내장-mcps)
2218
- [기타 편의 기능](#기타-편의-기능)
19+
- [설정](#설정)
2320
- [작성자의 노트](#작성자의-노트)
2421
- [주의](#주의)
2522

@@ -61,45 +58,6 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
6158
}
6259
```
6360

64-
## 설정
65-
66-
`oh-my-opencode.json` (또는 `.oh-my-opencode.json`) 파일을 프로젝트 루트에 생성해서 Oh My OpenCode를 입맛대로 설정할 수 있어.
67-
68-
```json
69-
{
70-
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
71-
}
72-
```
73-
74-
설정 파일은 스키마를 통해 자동완성을 지원합니다. 자세한 내용은 각 기능 섹션에서 설명합니다.
75-
76-
### 특정 MCP 비활성화
77-
78-
특정 MCP가 거슬린다면 끌 수 있어.
79-
80-
```json
81-
{
82-
"disabled_mcps": ["websearch_exa"]
83-
}
84-
```
85-
86-
### 특정 Agent 비활성화
87-
88-
특정 에이전트가 마음에 안 들거나, 토큰을 아끼고 싶다면 비활성화해.
89-
비활성화 가능한 목록: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
90-
91-
```json
92-
{
93-
"disabled_agents": ["frontend-ui-ux-engineer"]
94-
}
95-
```
96-
97-
### Agent 설정
98-
99-
`agents` 옵션으로 에이전트의 모델, 프롬프트, 권한 등을 세밀하게 조정할 수 있습니다. 스키마를 통해 자동완성을 지원합니다.
100-
101-
전체 설정 옵션과 예시는 [OpenCode Agents 문서](https://opencode.ai/docs/agents)를 참고하세요.
102-
10361
## LLM Agent를 위한 안내
10462

10563
<details>
@@ -188,23 +146,7 @@ OpenCode 는 아주 확장가능하고 아주 커스터마이저블합니다.
188146
- **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): 개발자로 전향한 디자이너라는 설정을 갖고 있습니다. 멋진 UI를 만듭니다. 아름답고 창의적인 UI 코드를 생성하는 데 탁월한 Gemini를 사용합니다.
189147
- **document-writer** (`google/gemini-3-pro-preview`): 기술 문서 전문가라는 설정을 갖고 있습니다. Gemini 는 문학가입니다. 글을 기가막히게 씁니다.
190148

191-
#### 설정
192-
193-
에이전트들은 OpenCode와 동일한 설정 스펙을 따릅니다:
194-
195-
- **모델 변경**: `agents.{name}.model`로 에이전트 모델 오버라이드. [OpenCode Models](https://opencode.ai/docs/models/#configure-models) 참고.
196-
- **에이전트 비활성화**: `disabled_agents` 또는 `agents.{name}.disable` 사용. [OpenCode Agents](https://opencode.ai/docs/agents) 참고.
197-
198-
권장하진 않지만(이 플러그인은 멀티 모델 오케스트레이션용), Anthropic만 사용하는 경우 예시:
199-
200-
```json
201-
{
202-
"agents": {
203-
"explore": { "model": "anthropic/claude-haiku-4-5" },
204-
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" }
205-
}
206-
}
207-
```
149+
에이전트의 모델, 프롬프트, 권한은 `oh-my-opencode.json`에서 커스텀할 수 있습니다. 자세한 내용은 [설정](#설정)을 참고하세요.
208150

209151
### Tools
210152

@@ -239,9 +181,89 @@ OpenCode 는 아주 확장가능하고 아주 커스터마이저블합니다.
239181
- **websearch_exa**: Exa AI 웹 검색. 실시간 웹 검색과 콘텐츠 스크래핑을 수행합니다. 관련 웹사이트에서 LLM에 최적화된 컨텍스트를 반환합니다.
240182
- **context7**: 라이브러리 문서 조회. 정확한 코딩을 위해 최신 라이브러리 문서를 가져옵니다.
241183

184+
필요 없다면 `oh-my-opencode.json`에서 비활성화할 수 있습니다:
185+
186+
```json
187+
{
188+
"disabled_mcps": ["websearch_exa"]
189+
}
190+
```
191+
242192
### 기타 편의 기능
243193
- **Terminal Title**: 세션 상태에 따라 터미널 타이틀을 자동 업데이트합니다 (유휴 ○, 처리중 ◐, 도구 ⚡, 에러 ✖). tmux를 지원합니다.
244194

195+
## 설정
196+
197+
설정 파일 위치 (우선순위 순):
198+
1. `.opencode/oh-my-opencode.json` (프로젝트)
199+
2. `~/.config/opencode/oh-my-opencode.json` (사용자)
200+
201+
Schema 자동 완성이 지원됩니다:
202+
203+
```json
204+
{
205+
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
206+
}
207+
```
208+
209+
### Agents
210+
211+
`agents.{name}`을 통해 에이전트의 모델, 프롬프트, 권한을 오버라이드할 수 있습니다. [OpenCode Agents](https://opencode.ai/docs/agents)를 참조하세요.
212+
213+
```json
214+
{
215+
"agents": {
216+
"explore": { "model": "anthropic/claude-haiku-4-5" },
217+
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" }
218+
}
219+
}
220+
```
221+
222+
에이전트를 완전히 비활성화할 수도 있습니다:
223+
224+
```json
225+
{
226+
"disabled_agents": ["oracle", "frontend-ui-ux-engineer"]
227+
}
228+
```
229+
230+
사용 가능: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
231+
232+
### MCPs
233+
234+
내장된 MCP를 비활성화합니다:
235+
236+
```json
237+
{
238+
"disabled_mcps": ["context7", "websearch_exa"]
239+
}
240+
```
241+
242+
더 자세한 내용은 [OpenCode MCP Servers](https://opencode.ai/docs/mcp-servers)를 참조하세요.
243+
244+
### LSP
245+
246+
Oh My OpenCode의 LSP 도구는 오직 **리팩토링(이름 변경, 코드 액션)만을 위한 것**입니다. 분석용 LSP는 OpenCode 자체에서 처리합니다.
247+
248+
`lsp` 옵션을 통해 LSP 서버를 설정합니다:
249+
250+
```json
251+
{
252+
"lsp": {
253+
"typescript-language-server": {
254+
"command": ["typescript-language-server", "--stdio"],
255+
"extensions": [".ts", ".tsx"],
256+
"priority": 10
257+
},
258+
"pylsp": {
259+
"disabled": true
260+
}
261+
}
262+
}
263+
```
264+
265+
각 서버는 다음을 지원합니다: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
266+
245267
## 작성자의 노트
246268

247269
Oh My OpenCode 를 설치하세요. 복잡하게 OpenCode 구성을 만들지마세요.

‎README.md‎

Lines changed: 82 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,6 @@ English | [한국어](README.ko.md)
66
- [TL;DR](#tldr)
77
- [Installation](#installation)
88
- [For LLM Agents](#for-llm-agents)
9-
- [Configuration](#configuration)
10-
- [Disable specific MCPs](#disable-specific-mcps)
11-
- [Disable specific Agents](#disable-specific-agents)
12-
- [Agent Configuration](#agent-configuration)
139
- [Why OpenCode & Why Oh My OpenCode](#why-opencode--why-oh-my-opencode)
1410
- [Features](#features)
1511
- [Hooks](#hooks)
@@ -20,6 +16,7 @@ English | [한국어](README.ko.md)
2016
- [Safe Grep](#safe-grep)
2117
- [Built-in MCPs](#built-in-mcps)
2218
- [Other Features](#other-features)
19+
- [Configuration](#configuration)
2320
- [Author's Note](#authors-note)
2421
- [Warnings](#warnings)
2522

@@ -110,46 +107,6 @@ cat ~/.config/opencode/opencode.json # Should contain "oh-my-opencode" in plugi
110107
111108
</details>
112109

113-
## Configuration
114-
115-
You can configure Oh My OpenCode by creating a `oh-my-opencode.json` (or `.oh-my-opencode.json`) file in your project root.
116-
117-
Configuration supports autocomplete via schema. Details are covered in each feature section below.
118-
119-
```json
120-
{
121-
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
122-
}
123-
```
124-
125-
### Disable specific MCPs
126-
127-
If you want to disable specific built-in MCPs, you can use the `disabled_mcps` option.
128-
129-
```json
130-
{
131-
"disabled_mcps": ["context7", "websearch_exa"]
132-
}
133-
```
134-
135-
### Disable specific Agents
136-
137-
If you want to disable specific built-in agents, you can use the `disabled_agents` option.
138-
139-
```json
140-
{
141-
"disabled_agents": ["explore", "frontend-ui-ux-engineer"]
142-
}
143-
```
144-
145-
Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
146-
147-
### Agent Configuration
148-
149-
You can override any built-in agent's model, prompt, permissions, and more using the `agents` option. Configuration uses autocomplete via schema.
150-
151-
For full configuration options and examples, see the [OpenCode Agents documentation](https://opencode.ai/docs/agents).
152-
153110
## Why OpenCode & Why Oh My OpenCode
154111

155112
OpenCode is limitlessly extensible and customizable. Zero screen flicker.
@@ -185,23 +142,7 @@ I believe in the right tool for the job. For your wallet's sake, use CLIProxyAPI
185142
- **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): A designer turned developer. Creates stunning UIs. Uses Gemini because its creativity and UI code generation are superior.
186143
- **document-writer** (`google/gemini-3-pro-preview`): A technical writing expert. Gemini is a wordsmith; it writes prose that flows naturally.
187144

188-
#### Configuration
189-
190-
Agents follow the same configuration spec as OpenCode:
191-
192-
- **Change models**: Override any agent's model via `agents.{name}.model`. See [OpenCode Models](https://opencode.ai/docs/models/#configure-models).
193-
- **Disable agents**: Use `disabled_agents` or `agents.{name}.disable`. See [OpenCode Agents](https://opencode.ai/docs/agents).
194-
195-
While not generally recommended (this plugin is designed for multi-model orchestration), here's an example for Anthropic-only users:
196-
197-
```json
198-
{
199-
"agents": {
200-
"explore": { "model": "anthropic/claude-haiku-4-5" },
201-
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" }
202-
}
203-
}
204-
```
145+
Agent models, prompts, and permissions can be customized via `oh-my-opencode.json`. See [Configuration](#configuration) for details.
205146

206147
### Tools
207148

@@ -238,10 +179,90 @@ While not generally recommended (this plugin is designed for multi-model orchest
238179
- **websearch_exa**: Exa AI web search. Performs real-time web searches and can scrape content from specific URLs. Returns LLM-optimized context from relevant websites.
239180
- **context7**: Library documentation lookup. Fetches up-to-date documentation for any library to assist with accurate coding.
240181

182+
Don't need these? Disable them via `oh-my-opencode.json`:
183+
184+
```json
185+
{
186+
"disabled_mcps": ["websearch_exa"]
187+
}
188+
```
189+
241190
### Other Features
242191

243192
- **Terminal Title**: Auto-updates terminal title with session status (idle ○, processing ◐, tool ⚡, error ✖). Supports tmux.
244193

194+
## Configuration
195+
196+
Configuration file locations (in priority order):
197+
1. `.opencode/oh-my-opencode.json` (project)
198+
2. `~/.config/opencode/oh-my-opencode.json` (user)
199+
200+
Schema autocomplete is supported:
201+
202+
```json
203+
{
204+
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/dist/oh-my-opencode.schema.json"
205+
}
206+
```
207+
208+
### Agents
209+
210+
Override any agent's model, prompt, or permissions via `agents.{name}`. See [OpenCode Agents](https://opencode.ai/docs/agents).
211+
212+
```json
213+
{
214+
"agents": {
215+
"explore": { "model": "anthropic/claude-haiku-4-5" },
216+
"frontend-ui-ux-engineer": { "model": "anthropic/claude-opus-4" }
217+
}
218+
}
219+
```
220+
221+
Disable agents entirely:
222+
223+
```json
224+
{
225+
"disabled_agents": ["oracle", "frontend-ui-ux-engineer"]
226+
}
227+
```
228+
229+
Available: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`
230+
231+
### MCPs
232+
233+
Disable built-in MCPs:
234+
235+
```json
236+
{
237+
"disabled_mcps": ["context7", "websearch_exa"]
238+
}
239+
```
240+
241+
See [OpenCode MCP Servers](https://opencode.ai/docs/mcp-servers) for more.
242+
243+
### LSP
244+
245+
Oh My OpenCode's LSP tools are for **refactoring only** (rename, code actions). Analysis LSP is handled by OpenCode itself.
246+
247+
Configure LSP servers via `lsp` option:
248+
249+
```json
250+
{
251+
"lsp": {
252+
"typescript-language-server": {
253+
"command": ["typescript-language-server", "--stdio"],
254+
"extensions": [".ts", ".tsx"],
255+
"priority": 10
256+
},
257+
"pylsp": {
258+
"disabled": true
259+
}
260+
}
261+
}
262+
```
263+
264+
Each server supports: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
265+
245266
## Author's Note
246267

247268
Install Oh My OpenCode. Do not waste time configuring OpenCode from scratch.

0 commit comments

Comments
 (0)