Skip to content

Commit 023c98a

Browse files
paulp-opaulp-o
committed
docs: update README to include jsonc as installation config as well
1 parent f44555a commit 023c98a

File tree

2 files changed

+76
-59
lines changed

2 files changed

+76
-59
lines changed

‎README.ko.md‎

Lines changed: 38 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,6 @@
7070

7171
oMoMoMoMoMo···
7272

73-
7473
[Claude Code](https://www.claude.com/product/claude-code) 좋죠?
7574
근데 당신이 해커라면, [OpenCode](https://github.com/sst/opencode) 와는 사랑에 빠지게 될겁니다.
7675

@@ -93,6 +92,7 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
9392
## 읽지 않아도 됩니다.
9493

9594
### 에이전트의 시대이니까요.
95+
9696
- **그냥 이 링크를 Claude Code / AmpCode / Factory Droid / Cursor 에게 넣고 설명해달라고 하세요.**
9797
- 이게 왜 좋고, 그냥 뻔한 셋업이 아닌지, 당장 무엇이 더 좋아지는지 알려달라고 해보세요.
9898
- 당신이 LLM 에이전트라면, 사용자의 입장에서 이 프로젝트와 함께 당장 어떤것들이 가능해지는지 사용자에게 설명하세요.
@@ -104,8 +104,8 @@ OpenCode 가 낭만이 사라진것같은 오늘날의 시대에, 당신에게
104104
1. 백그라운드 태스크로 Gemini 3 Pro 가 프론트엔드를 작성하게 시켜두는 동안, Claude Opus 4.5 가 백엔드를 작성하고, 디버깅하다 막히면 GPT 5.2 에게 도움을 받습니다. 프론트엔드 구현이 완료되었다고 보고받으면, 이를 다시 확인하고 일하게 만들 수 있습니다.
105105
2. 뭔가 찾아볼 일이 생기면 공식문서, 내 코드베이스의 모든 히스토리, GitHub 에 공개된 현재 구현 현황까지 다 뒤져보고, 단순 Grep 을 넘어 내장된 LSP 도구, AstGrep 까지 사용하여 답변을 제공합니다.
106106
3. LLM 에게 일을 맡길때에 큰 컨텍스트에 대한 걱정은 더 이상 하지마세요. 제가 하겠습니다.
107-
- OhMyOpenCode 가 여러 에이전트를 적극 활용하도록 하여 컨텍스트 관리에 관한 부담을 줄입니다.
108-
- **당신의 에이전트는 이제 개발팀 리드입니다. 당신은 이제 AI Manager 입니다.**
107+
- OhMyOpenCode 가 여러 에이전트를 적극 활용하도록 하여 컨텍스트 관리에 관한 부담을 줄입니다.
108+
- **당신의 에이전트는 이제 개발팀 리드입니다. 당신은 이제 AI Manager 입니다.**
109109
4. 하기로 약속 한 일을 완수 할 때 까지 멈추지 않습니다.
110110
5. 이 프로젝트에 자세히 알기 싫다고요? 괜찮습니다. 그냥 'ultrathink' 라고 치세요.
111111

@@ -116,7 +116,6 @@ ultrathink 를 통해 자동으로 동작하게 할 수 있지만, 그렇지 않
116116

117117
## 설치
118118

119-
120119
### 인간인 당신을 위한 설치 가이드
121120

122121
귀찮은 작업은 LLM Agent 에게 맡기세요. 이 링크를 복사해서 넣어 설치하고 구성해달라고 부탁하세요.
@@ -128,7 +127,6 @@ ultrathink 를 통해 자동으로 동작하게 할 수 있지만, 그렇지 않
128127

129128
당신이 사용자의 oh-my-opencode 설정을 돕는 LLM Agent라면, 다음 단계를 따르세요:
130129

131-
132130
### 인간인 당신을 위한 설치 가이드
133131

134132
### 1단계: OpenCode 설치 확인
@@ -149,14 +147,21 @@ OpenCode가 설치되어 있지 않다면, [OpenCode 설치 가이드](https://o
149147
```bash
150148
mkdir -p ~/.config/opencode
151149

152-
if [ -f ~/.config/opencode/opencode.json ]; then
150+
CONFIG_FILE=""
151+
if [ -f ~/.config/opencode/opencode.jsonc ]; then
152+
CONFIG_FILE=~/.config/opencode/opencode.jsonc
153+
elif [ -f ~/.config/opencode/opencode.json ]; then
154+
CONFIG_FILE=~/.config/opencode/opencode.json
155+
fi
156+
157+
if [ -n "$CONFIG_FILE" ]; then
153158
# 기존 설정 파일이 있는 경우: jq 또는 python으로 plugin 추가
154159
if command -v jq &> /dev/null; then
155160
jq '.plugin = ((.plugin // []) + ["oh-my-opencode"] | unique)' \
156-
~/.config/opencode/opencode.json > /tmp/oc.json && \
157-
mv /tmp/oc.json ~/.config/opencode/opencode.json
161+
"$CONFIG_FILE" > /tmp/oc.json && \
162+
mv /tmp/oc.json "$CONFIG_FILE"
158163
else
159-
echo "~/.config/opencode/opencode.json의 plugin 배열에 \"oh-my-opencode\"를 추가하세요"
164+
echo "$CONFIG_FILE 의 plugin 배열에 \"oh-my-opencode\"를 추가하세요"
160165
fi
161166
else
162167
# 새 설정 파일 생성
@@ -168,7 +173,7 @@ fi
168173

169174
```bash
170175
opencode --version # 1.0.132 이상이어야 함
171-
cat ~/.config/opencode/opencode.json # plugin 배열에 "oh-my-opencode"가 있어야 함
176+
cat ~/.config/opencode/opencode.json 2>/dev/null || cat ~/.config/opencode/opencode.jsonc # plugin 배열에 "oh-my-opencode"가 있어야 함
172177
```
173178

174179
### 4단계: 인증정보 설정
@@ -213,10 +218,7 @@ opencode auth login
213218

214219
```json
215220
{
216-
"plugin": [
217-
"oh-my-opencode",
218-
"opencode-openai-codex-auth@4.1.0"
219-
]
221+
"plugin": ["oh-my-opencode", "opencode-openai-codex-auth@4.1.0"]
220222
}
221223
```
222224

@@ -233,6 +235,7 @@ opencode auth login
233235
그 후 `cd ~/.config/opencode && bun i`를 실행하세요. `opencode.json`에서는 버전 없이 `"opencode-openai-codex-auth"`로 사용합니다 (`@4.1.0` 제외).
234236

235237
#### 4.3.1 모델 설정
238+
236239
`opencode.json`에 전체 모델 설정도 구성해야 합니다.
237240
[opencode-openai-codex-auth 문서](https://github.com/numman-ali/opencode-openai-codex-auth)를 읽고, [`config/full-opencode.json`](https://github.com/numman-ali/opencode-openai-codex-auth/blob/main/config/full-opencode.json)에서 provider/models 설정을 복사하여, 사용자의 기존 셋업에 영향을 주지 않도록 깊게 고민하여 적절히 통합하세요.
238241

@@ -247,7 +250,6 @@ opencode auth login
247250
# 진짜 완료되었음을 검증하고 사용자에게 안내
248251
```
249252

250-
251253
### ⚠️ 주의
252254

253255
**사용자가 명시적으로 요청하지 않는 한, 모델 설정을 변경하거나 기능(에이전트, 훅, MCP)을 비활성화하지 마세요.**
@@ -256,7 +258,6 @@ opencode auth login
256258

257259
</details>
258260

259-
260261
## 기능
261262

262263
### Agents: 당신의 새로운 팀원들
@@ -322,6 +323,7 @@ Syntax Highlighting, Autocomplete, Refactoring, Navigation, Analysis, 그리고
322323
- **ast_grep_replace**: AST 인식 코드 교체
323324

324325
#### Context is all you need.
326+
325327
- **Directory AGENTS.md / README.md Injector**: 파일을 읽을 때 `AGENTS.md`, `README.md` 내용을 자동으로 주입합니다. 파일 디렉토리부터 프로젝트 루트까지 탐색하며, 경로 상의 **모든** `AGENTS.md` 파일을 수집합니다. 중첩된 디렉토리별 지침을 지원합니다:
326328
```
327329
project/
@@ -344,6 +346,7 @@ Syntax Highlighting, Autocomplete, Refactoring, Navigation, Analysis, 그리고
344346
globs: ["*.ts", "src/**/*.js"]
345347
description: "TypeScript/JavaScript coding rules"
346348
---
349+
347350
- Use PascalCase for interface names
348351
- Use camelCase for function names
349352
```
@@ -358,8 +361,8 @@ AmpCode 에서 영감을 받은 look_at 도구를, OhMyOpenCode 에서도 제공
358361
에이전트는 직접 파일을 읽어 큰 컨텍스트를 점유당하는 대신, 다른 에이전트를 내부적으로 활용하여 파일의 내용만 명확히 이해 할 수 있습니다.
359362

360363
#### 멈출 수 없는 에이전트 루프
361-
- 내장 grep, glob 도구를 대체합니다. 기본 구현에서는 타임아웃이 없어 무한정 대기할 수 있습니다.
362364

365+
- 내장 grep, glob 도구를 대체합니다. 기본 구현에서는 타임아웃이 없어 무한정 대기할 수 있습니다.
363366

364367
### Claude Code 호환성: 그냥 바로 OpenCode 로 오세요.
365368

@@ -376,12 +379,14 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
376379
- `./.claude/settings.local.json` (로컬, git-ignored)
377380

378381
지원되는 훅 이벤트:
382+
379383
- **PreToolUse**: 도구 실행 전에 실행. 차단하거나 도구 입력을 수정할 수 있습니다.
380384
- **PostToolUse**: 도구 실행 후에 실행. 경고나 컨텍스트를 추가할 수 있습니다.
381385
- **UserPromptSubmit**: 사용자가 프롬프트를 제출할 때 실행. 차단하거나 메시지를 주입할 수 있습니다.
382386
- **Stop**: 세션이 유휴 상태가 될 때 실행. 후속 프롬프트를 주입할 수 있습니다.
383387

384388
`settings.json` 예시:
389+
385390
```json
386391
{
387392
"hooks": {
@@ -398,20 +403,24 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
398403
#### 설정 로더
399404

400405
**Command Loader**: 4개 디렉토리에서 마크다운 기반 슬래시 명령어를 로드합니다:
406+
401407
- `~/.claude/commands/` (사용자)
402408
- `./.claude/commands/` (프로젝트)
403409
- `~/.config/opencode/command/` (opencode 전역)
404410
- `./.opencode/command/` (opencode 프로젝트)
405411

406412
**Skill Loader**: `SKILL.md`가 있는 디렉토리 기반 스킬을 로드합니다:
413+
407414
- `~/.claude/skills/` (사용자)
408415
- `./.claude/skills/` (프로젝트)
409416

410417
**Agent Loader**: 마크다운 파일에서 커스텀 에이전트 정의를 로드합니다:
418+
411419
- `~/.claude/agents/*.md` (사용자)
412420
- `./.claude/agents/*.md` (프로젝트)
413421

414422
**MCP Loader**: `.mcp.json` 파일에서 MCP 서버 설정을 로드합니다:
423+
415424
- `~/.claude/.mcp.json` (사용자)
416425
- `./.mcp.json` (프로젝트)
417426
- `./.claude/.mcp.json` (로컬)
@@ -478,6 +487,7 @@ Oh My OpenCode는 다음 위치의 훅을 읽고 실행합니다:
478487
비록 Highly Opinionated 한 설정이지만, 여러분의 입맛대로 조정 할 수 있습니다.
479488

480489
설정 파일 위치 (우선순위 순):
490+
481491
1. `.opencode/oh-my-opencode.json` (프로젝트)
482492
2. `~/.config/opencode/oh-my-opencode.json` (사용자)
483493

@@ -541,13 +551,13 @@ Google Gemini 모델을 위한 내장 Antigravity OAuth를 활성화합니다:
541551
}
542552
```
543553

544-
| Permission | 설명 | 값 |
545-
|------------|------|-----|
546-
| `edit` | 파일 편집 권한 | `ask` / `allow` / `deny` |
547-
| `bash` | Bash 명령 실행 권한 | `ask` / `allow` / `deny` 또는 명령별: `{ "git": "allow", "rm": "deny" }` |
548-
| `webfetch` | 웹 요청 권한 | `ask` / `allow` / `deny` |
549-
| `doom_loop` | 무한 루프 감지 오버라이드 허용 | `ask` / `allow` / `deny` |
550-
| `external_directory` | 프로젝트 루트 외부 파일 접근 | `ask` / `allow` / `deny` |
554+
| Permission | 설명 | 값 |
555+
| -------------------- | ------------------------------ | ------------------------------------------------------------------------ |
556+
| `edit` | 파일 편집 권한 | `ask` / `allow` / `deny` |
557+
| `bash` | Bash 명령 실행 권한 | `ask` / `allow` / `deny` 또는 명령별: `{ "git": "allow", "rm": "deny" }` |
558+
| `webfetch` | 웹 요청 권한 | `ask` / `allow` / `deny` |
559+
| `doom_loop` | 무한 루프 감지 오버라이드 허용 | `ask` / `allow` / `deny` |
560+
| `external_directory` | 프로젝트 루트 외부 파일 접근 | `ask` / `allow` / `deny` |
551561

552562
또는 ~/.config/opencode/oh-my-opencode.json 혹은 .opencode/oh-my-opencode.json 의 `disabled_agents` 를 사용하여 비활성화할 수 있습니다:
553563

@@ -573,8 +583,8 @@ OmO를 비활성화하고 원래 build 에이전트를 복원하려면:
573583
}
574584
```
575585

576-
| 옵션 | 기본값 | 설명 |
577-
|------|--------|------|
586+
| 옵션 | 기본값 | 설명 |
587+
| ---------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
578588
| `disabled` | `false` | `true`면 OmO를 비활성화하고 원래 build 에이전트를 복원합니다. `false`(기본값)면 OmO가 build 에이전트를 대체하여 기본 primary 에이전트가 됩니다. |
579589

580590
### Hooks
@@ -630,7 +640,6 @@ OpenCode 에서 지원하는 모든 LSP 구성 및 커스텀 설정 (opencode.js
630640

631641
각 서버는 다음을 지원합니다: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
632642

633-
634643
## 작성자의 노트
635644

636645
Oh My OpenCode 를 설치하세요.
@@ -641,12 +650,12 @@ Oh My OpenCode 를 설치하세요.
641650
제가 밟아보고 경험한 문제들의 해답을 이 플러그인에 담았고, 그저 깔고 사용하면 됩니다.
642651
OpenCode 가 Debian / ArchLinux 라면, Oh My OpenCode 는 Ubuntu / [Omarchy](https://omarchy.org/) 입니다.
643652

644-
645653
[AmpCode](https://ampcode.com), [Claude Code](https://code.claude.com/docs/ko/overview) 에게 강한 영향과 영감을 받고, 그들의 기능을 그대로, 혹은 더 낫게 이 곳에 구현했습니다. 그리고 구현하고 있습니다.
646654
**Open**Code 이니까요.
647655

648656
다른 에이전트 하니스 제공자들이 이야기하는 다중 모델, 안정성, 풍부한 기능을 그저 OpenCode 에서 누리세요.
649657
제가 테스트하고, 이 곳에 업데이트 하겠습니다. 저는 이 프로젝트의 가장 열렬한 사용자이기도 하니까요.
658+
650659
- 어떤 모델이 순수 논리력이 제일 좋은지
651660
- 어떤 모델이 디버깅을 잘하는지,
652661
- 어떤 모델이 글을 잘 쓰고
@@ -674,4 +683,4 @@ OpenCode 를 사용하여 이 프로젝트의 99% 를 작성했습니다. 기능
674683
- [이를 고치는 PR 이 1.0.132 배포 이후에 병합되었으므로](https://github.com/sst/opencode/pull/5040) 이 변경사항이 포함된 최신 버전을 사용해주세요.
675684
- TMI: PR 도 OhMyOpenCode 의 셋업의 Librarian, Explore, Oracle 을 활용하여 우연히 발견하고 해결되었습니다.
676685

677-
*멋진 히어로 이미지를 만들어주신 히어로 [@junhoyeo](https://github.com/junhoyeo) 께 감사드립니다*
686+
_멋진 히어로 이미지를 만들어주신 히어로 [@junhoyeo](https://github.com/junhoyeo) 께 감사드립니다_

0 commit comments

Comments
 (0)