oh-my-pi

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 25,225 Open GitHub ↗

⌥ 터미널용 AI 코딩 에이전트 — 해시 앵커 기반 편집, 최적화된 툴 하네스, LSP, Python, 브라우저, 서브에이전트 등을 지원합니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

IDE가 내장된 코딩 에이전트.
 <a href="https://omp.sh">omp.sh</a>

<a href="https://github.com/mariozechner">@mariozechner</a>의 <a href="https://github.com/badlogic/pi-mono">Pi</a>를 포크한 프로젝트입니다.

실제로 배포된 가장 강력한 에이전트 인터페이스입니다. 실제 사용 사례를 통해 지속적으로 튜닝되었으며, 설치 즉시 모든 기능을 사용할 수 있고 내부 구조가 완전히 공개되어 있습니다.

**60개 이상의** 제공자 · **31개의** 내장 툴 · **14개의** LSP 작업 · **28개의** DAP 작업 · **약 8만 라인**의 Rust 코어.

> [!NOTE]
> Pull request는 현재 테스트 기간으로 **모두에게 일시적으로 개방**되어 있습니다. 이전에는 PR 수락 전 추천(vouch) 단계가 필요했으나, 오픈 기여 방식을 평가하는 동안 이 요구 사항은 해제되었습니다. 결과에 따라 추천 시스템이 다시 도입될 수 있습니다.

## 설치

**macOS · Linux**

```sh
curl -fsSL https://omp.sh/install | sh
```

> **Alpine / musl:** 사전 빌드된 musl 바이너리는 `libstdc++`/`libgcc`를 동적으로 링크하지만, 순정 Alpine에는 포함되어 있지 않습니다. 먼저 `apk add libstdc++ libgcc`를 설치하세요.

**Homebrew**

```sh
brew install can1357/tap/omp
```

**Bun (권장)**

```sh
bun install -g @oh-my-pi/pi-coding-agent
```

**Windows (PowerShell)**

```powershell
irm https://omp.sh/install.ps1 | iex
```

**버전 고정 (mise)**

```sh
mise use -g github:can1357/oh-my-pi
```

macOS · Linux · Windows · bun ≥ 1.3.14

### 셸 완성 (Shell completions)

`omp`는 실제 명령어/플래그 메타데이터를 바탕으로 **bash**, **zsh**, **fish**를 위한 자체 완성 스크립트를 생성하므로, 실제 CLI와 일치하지 않는 경우가 없습니다. 서브커맨드, 플래그, 열거형 값은 정적으로 완성되며, 모델 이름(`--model`, `--smol`, `--slow`, `--plan`)은 번들된 모델 카탈로그에서, `--resume`은 디스크상의 세션에서 확인하여 완성합니다.

```sh
# zsh — ~/.zshrc에 추가 (또는 $fpath의 파일로 출력 저장)
eval "$(omp completions zsh)"

# bash — ~/.bashrc에 추가
eval "$(omp completions bash)"

# fish
omp completions fish > ~/.config/fish/completions/omp.fish
```

## 모든 툴, _성능 극대화_.

첫 시도에 성공하는 편집. 파일 내용을 쏟아내는 대신 요약해서 읽어주는 읽기 기능. 즉각적인 검색 결과. 어떤 모델을 선택하든 `omp`가 정확하게 처리합니다.

| 모델            | 지표       | 내용                                                                  |
| ---------------- | ------------ | --------------------------------------------------------------------- |
| Grok Code Fast 1 | 6.7% → 68.3% | 편집 포맷이 모델을 방해하지 않게 된 순간 성능이 10배 향상되었습니다. |
| Gemini 3 Flash   | +5 pp        | str_replace 대비 우수하며, Google의 자체 포맷 시도보다 뛰어납니다.     |
| Grok 4 Fast      | −61% tokens  | 잘못된 diff에 대한 재시도 루프가 사라지면서 출력 토큰이 급감했습니다.         |
| MiniMax          | 2.1×         | 통과율이 두 배 이상 증가했습니다. 동일한 가중치와 프롬프트를 사용했습니다.               |

- `read` : 요약된 스니펫 · 이상적인 기본값 · 선택자 적중률
- `grep` : 압도적인 검색 속도
- `lsp` : IDE가 알고 있는 모든 것을 에이전트도 알 수 있습니다
- `prompts` : 각 모델에 맞춰 끊임없이 조정되었습니다

[전체 포스트 읽기 ↗](https://blog.can.ac/2026/02/12/the-harness-problem/)

## _당신이 사랑하는_ Pi, **모든 기능 내장**.

[Mario Zechner](https://github.com/mariozechner)의 훌륭한 [Pi](https://github.com/badlogic/pi-mono)를 기반으로 구축된 `omp`는 부족했던 모든 기능을 추가했습니다.

### 01 · 툴 호출을 통한 코드 실행

대부분의 하네스는 에이전트에게 Python 샌드박스를 제공하는 것으로 끝냅니다. `omp`는 영구적인 Python과 Bun 워커를 실행하며, 각 커널은 루프백 브리지를 통해 에이전트 자체의 툴(read, search, task 등)을 다시 호출할 수 있습니다. 에이전트는 Python 내부에서 `tool.read`로 CSV를 로드하고, JavaScript로 차트를 그리며, 셀을 벗어나지 않고 작업을 완료합니다.

![omp TUI: `[1/2] pandas describe` (Python)가 실제 DataFrame.describe() 테이블을 출력하고, 이어서 `[2/2] top scorer` (JavaScript)가 reduce를 실행하는 단일 eval 세션. 하단: '두 커널이 한 세션에서 실행되었습니다.'](https://omp.sh/captures/eval.webp)

### 02 · 모든 쓰기 작업에 LSP 연결

이름 변경을 요청하면 실제로 변경됩니다. 호출은 `workspace/willRenameFiles`를 통해 이루어지므로, 파일이 이동하기 전에 재내보내기(re-exports), 배럴 파일, 별칭 임포트가 모두 업데이트됩니다. IDE가 알고 있는 모든 것을 에이전트도 압니다.

![omp TUI: `LSP references`가 `formatBytes` 심볼에 대해 3개 파일에서 5개의 검색 결과를 반환하고, `LSP rename`이 format.ts/report.ts/cli.ts에 변경 사항을 적용한 뒤, `Search formatBytes 0 matches`로 확인하는 과정. 마지막 줄: '이름 변경 완료. 3개 파일에서 5개 편집 적용…'.](https://omp.sh/captures/lsp.webp)

_[LSP 설정 문서 읽기](docs/lsp-config.md)_

### 03 · 실제 디버거 구동

C 바이너리에서 segfault가 발생하면, 에이전트가 `lldb`를 연결하고 잘못된 포인터로 단계별 실행(step)을 하며 프레임을 읽습니다. Go 서비스가 멈추면 `dlv`를 연결해 고루틴을 살펴봅니다. Python 프로세스가 엉키면 `debugpy`로 일시 중지하고 검사 및 평가를 수행합니다. 대부분의 에이전트가 여전히 print 문을 뿌리고 있을 때 말이죠.

![omp TUI: /tmp/omp-native/demo의 네이티브 바이너리에 대한 라이브 lldb-dap 세션. Adapter=lldb-dap, Status=stopped, Frame=xorshift32, Instruction pointer 0x10000055C, Location demo.c:6:10. 디버그 범위 및 변수 카드가 로컬 변수 (x = 57351)를 보여주며 에이전트가 수학적 계산을 확인: x가 7 → 57351 (= 7 ^ (7<<13))로 변경됨.](https://omp.sh/clips/dap-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/dap.mp4)_

### 04 · 타임머신 스트림 규칙 (Time-traveling stream rules)

규칙은 모델이 정해진 시나리오를 벗어날 때까지 대기합니다. 정규식 일치 시 토큰 생성 중간에 스트림을 중단하고, 규칙을 시스템 리마인더로 주입한 뒤 같은 지점에서 재시도합니다. 매 턴마다 컨텍스트 비용을 지불하지 않고도 경로를 수정할 수 있습니다. 주입된 규칙은 압축 후에도 유지되므로 해결책이 지속됩니다.

![omp TUI: 에이전트가 src.rs를 읽고 Box::leak를 쓰려는 순간 요청이 중단되고 (빨간색 `Error: Request was aborted`), 황색 `⚠ Injecting rule: box-leak` 카드가 `Don't reach for Box::leak in production code paths` 규칙을 주입합니다. 이후 에이전트가 `Arc<str>`를 제안하며 사용자 확인을 요청하는 방식으로 경로를 수정합니다.](https://omp.sh/clips/ttsr-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/ttsr.mp4)_

### 05 · 일급 서브에이전트 (First-class subagents)

작업을 여러 워커로 분산하고 타입화된 결과를 받으세요. `task`는 격리된 워크트리로 팬아웃(fan-out)되며, 각 워커는 자체 툴 표면을 실행하고, 최종 결과물은 부모가 직접 읽을 수 있는 스키마 검증된 객체로 반환됩니다. 파싱해야 할 산문도, 형제 워커 간의 병합 충돌도, 버려진 편집 내용도 없습니다.

![omp TUI: `task`가 `ComponentsExports`와 `RoutesExports`라는 두 개의 서브에이전트를 생성하고, 제약 조건 블록에서 피어 간 IRC DM을 요구하며, 서브에이전트별 비용과 소요 시간이 표시된 상태 카드와 최종 Findings 섹션에 두 내보내기 결과 및 'IRC 조정 노트'가 표시되는 모습.](https://omp.sh/clips/irc-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/irc.mp4)_

### 06 · 모든 턴을 지켜보는 두 번째 모델.

리뷰어 모델을 'advisor' 역할로 페어링하면, 메인 에이전트의 모든 턴을 읽고 인라인으로 노트(조용한 조언, 우려 사항, 혹은 강력한 차단)를 주입합니다. 자체 컨텍스트와 모델로 실행되므로, 실행자가 서둘러 지나친 부분을 잡아냅니다. 메인 에이전트는 이 노트를 보고 경로를 수정하거나, 왜 그렇게 하지 않을지 설명합니다.

![omp TUI: /advisor 상태가 openai-codex/gpt-5.5에서 실행 중임을 보여줍니다. 메인 에이전트가 모든 에러를 삼키는 대신 ENOENT로 catch 범위를 좁힌 후, 황색 'Advisor 1 note (concern)' 카드가 이 수정 사항이 사용자의 문자 그대로의 수락 기준과 더 이상 일치하지 않는다고 경고합니다.](https://omp.sh/clips/advisor-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/advisor.mp4)_

### 07 · 링크 하나로 바로 접속.

`/collab`은 라이브 세션을 릴레이에 올리고 링크와 QR 코드를 제공합니다. 팀원은 `omp join`으로 다른 터미널에서 접속하거나 브라우저로 열 수 있습니다. 읽기-쓰기 권한을 공유하여 같은 에이전트에서 페어 프로그래밍을 하거나, `/collab view`로 누구나 볼 수 있지만 조작은 불가능한 읽기 전용 링크를 공유하세요. 프레임은 클라이언트 측에서 봉인되어 릴레이 서버가 키를 절대 볼 수 없습니다.

![omp TUI: /collab view가 'Collab session started!'와 함께 omp join 명령어, my.omp.sh 브라우저 링크, '이 링크가 있는 사람은 누구나 세션을 볼 수 있지만 에이전트에게 프롬프트를 보낼 수는 없습니다'라는 노트, 그리고 큰 QR 코드를 출력하는 모습.](https://omp.sh/clips/collab-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/collab.mp4)_

### 08 · arXiv의 PDF 읽기, 왜 안 되겠어요?

`web_search`는 23개의 순위 지정 제공자를 체이닝하고, 찾은 URL을 바로 `read`로 전달합니다. arXiv PDF, GitHub 페이지, Stack Overflow 스레드가 앵커가 유지된 구조화된 마크다운으로 반환됩니다. 로컬 파일에서 사용하는 것과 동일한 툴 표면을 사용합니다. 인용하고, 따라가고, 쿼트하며, 출처를 잃지 마세요.

![omp TUI: web_search가 추론 시간 연산 스케일링에 대해 10개의 Perplexity 소스를 반환하고, 에이전트가 arxiv 논문을 선택해 `read https://arxiv.org/pdf/2604.10739v1`를 호출하여 논문의 핵심 결과를 실제 수치와 함께 요약하는 모습.](https://omp.sh/clips/web-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/web.mp4)_

### 09 · 타협 없는 네이티브. Windows에서도.

다른 에이전트들은 `rg`, `grep`, `find`, `bash`를 셸 호출(shell out)합니다. 많은 머신에는 해당 바이너리가 없으며, 있더라도 매 호출마다 fork-exec 왕복 비용이 발생합니다. `omp`는 실제 구현체를 프로세스 내에 링크합니다. `ripgrep`, `glob`, `find`가 모두 인-프로세스(in-process)로 동작합니다. `brush`는 bash 역할을 하며 호출 간 세션을 유지하고, 46개의 vendored coreutils(`ls`, `sed`, `sort`, `xargs`, 심지어 `jaq`를 통한 `jq`까지)가 인-프로세스 내장 함수로 실행되어 fork/exec이 전혀 없습니다. 동일한 `omp` 바이너리가 macOS, Linux, Windows에서 실행되며 WSL 브리지가 필요 없습니다.

### 10 · 우선순위와 판정이 포함된 코드 리뷰

모든 이슈가 P0에서 P3까지 순위가 매겨지고 신뢰도 점수가 부여되어, 변경 사항을 배포할지 여부에 대한 명확한 판정을 받으세요. `/review`는 전용 리뷰어 서브에이전트를 생성하여 브랜치, 단일 커밋, 혹은 커밋되지 않은 작업을 병렬로 훑습니다. 릴리스를 막는 가장 중요한 문제부터 해결하세요. 산문 더미 속에 중요한 내용이 숨겨지지 않습니다.

### 11 · Hashline: 콘텐츠 해시 기반 편집

완벽한 편집, 더 적은 토큰. 모델이 변경하려는 라인을 다시 타이핑하는 대신 앵커를 가리키므로, 공백 문제나 '문자열을 찾을 수 없음' 루프가 사라집니다. 오래된 파일을 편집하여 앵커가 어긋나면, 파일이 손상되기 전에 패치를 거부합니다. Grok 4 Fast는 동일한 작업에 대해 출력 토큰을 61% 덜 사용합니다.

### 12 · GitHub는 그저 또 다른 파일 시스템일 뿐

다른 하네스들은 `gh_issue_view`, `gh_pr_view`, `gh_search` 등을 덧붙여 에이전트가 배워야 할 파라미터를 늘리고 사용자가 디버깅하게 만듭니다. 우리는 그 과정을 생략했습니다. `read`는 이미 경로를 처리하며, PR 역시 경로입니다. 모델이 배워야 할 인터페이스 하나, 정확하게 유지해야 할 표면 하나면 충분합니다.

### 13 · 에이전트가 직접 큐레이션하는 메모리

에이전트는 세션 사이에서도 코드베이스를 기억합니다. 실행 중에 `retain`으로 사실을 기록하고, `learn`으로 재사용 가능한 교훈을 캡처하며, `recall`로 이를 다시 불러오고, 각 세션을 다음 세션의 첫 턴에 로드되는 멘탈 모델로 압축합니다. `memory.backend`로 엔진(local, Hindsight, Mnemopi)을 선택하세요. 기본적으로 프로젝트 범위로 설정되어, 이 저장소에서 배운 내용은 이 저장소에만 머뭅니다.

### 14 · ACP: 에디터 주도형 에이전트

Zed 내부에서 `omp`를 실행하면 터미널에서 사용하던 것과 동일한 에이전트를 사용할 수 있습니다. 실제로 보고 있는 버퍼를 읽고, 에디터의 저장 경로를 통해 쓰고, 에디터 터미널에서 셸을 생성합니다. 파괴적인 툴은 권한 요청 프롬프트를 띄우며, 한 번만 답하면 다시 묻지 않습니다. 브리지도, 플러그인도, 동기화해야 할 두 번째 뇌도 필요 없습니다.

### 15 · 다른 툴들이 이미 작성한 내용을 상속

다른 모든 에이전트는 임포터를 제공하며 변환을 요구합니다. `omp`는 디스크에 이미 존재하는 8가지 포맷(Cursor MDC, Cline .clinerules, Codex AGENTS.md, Copilot applyTo 등)을 네이티브 형태로 읽습니다. 마이그레이션 스크립트도, YAML-to-TOML 변환도, "지원되는 일부 기능"이라는 각주도 없습니다. 지난 분기에 팀이 작성한 설정이 오늘 밤에도 그대로 작동합니다.

### 16 · omp commit: 원자적 분할, 검증된 메시지

`omp`는 `git_overview`, `git_file_diff`, `git_hunk`를 통해 워킹 트리를 읽은 뒤, 관련 없는 변경 사항을 의존성 순서에 따라 원자적(atomic) 커밋으로 분할합니다. 순환 의존성은 작성 전에 거부됩니다. 소스 파일이 테스트, 문서, 설정보다 높은 점수를 받으므로 가장 중요한 커밋이 헤드라인이 됩니다. 락 파일은 분석에서 완전히 제외됩니다.

### 17 · PR 읽기. _Skill 탐색._ 서브에이전트에서 JSON 추출.

`pr://`, `issue://`, `agent://`, `skill://`, `ssh://` 등 16개의 내부 스키마가 에이전트가 사용하는 모든 파일 시스템 형태의 툴 내에서 투명하게 해석됩니다. `read pr://1428`은 `read src/foo.ts`와 동일한 형태를 반환합니다. `grep`은 diff를 디렉토리처럼 탐색합니다. `agent://<id>/findings.0.path`는 경로를 통해 서브에이전트 출력의 특정 필드를 가져옵니다.

![omp TUI: pr://can1357/oh-my-pi/1063을 읽고 /diff/1을 보여주며, hunk 헤더, 추가된 라인, 그리고 [MODIFIED] (+12 -0) 요약을 표시하는 모습.](https://omp.sh/captures/pr.webp)

### 18 · 쉬워진 충돌 해결.

각 머지 충돌은 하나의 URL이 됩니다. 에이전트가 `conflict://N`에 `@theirs`, `@ours`, 또는 `@base`를 쓰면 파일이 깔끔하게 해결됩니다. 대량 처리 형태는 `conflict://*`입니다.

![omp TUI: ✓ Read src/session.ts (⚠ 1 conflict), 이후 ✓ Write conflict://1 · 1 line with content @theirs, 그리고 'Resolved' 확인 메시지가 나오는 과정.](https://omp.sh/clips/conflict-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/conflict.mp4)_

### 19 · 미리 보고 수락하기.

`ast_edit`는 교체 횟수가 포함된 _(proposed)_ 카드를 반환하고 변경 사항을 스테이징합니다. 에이전트가 `xd://resolve`에 한 줄의 이유를 쓰면, TUI가 이를 **Accept** 카드로 변환하고 디스크 반영이 이루어집니다. 원자적으로, 전부 적용되거나 전혀 적용되지 않습니다.

![omp TUI: ✓ AST Edit: console.log($X) (proposed) 3 replacements · 1 file, 이후 ✓ Accept: 3 replacements in 1 file (AST Edit), 그리고 'Applied 3 replacements in src/auth.ts' 메시지가 출력되는 과정.](https://omp.sh/clips/codemod-poster.webp)

_[캡처 영상 보기 ↗](https://omp.sh/clips/codemod.mp4)_

### 20 · _실제 브라우저_ 구동. _Slack도 가능할까요?_

기본적으로 Stealth 모드가 활성화되어 있어 페이지에서는 헤드리스 봇이 아닌 일반 사용자로 인식합니다. 동일한 API로 모든 Electron 앱을 제어할 수 있습니다. Slack을 지정하면 에이전트가 웹을 읽듯이 DM을 읽습니다. 샌드박스를 완전히 건너뛸 수도 있습니다. 브라우저 릴레이 확장 프로그램을 사용하면 에이전트가 포커스를 뺏지 않고 이미 열려 있는 Chrome 탭을 그대로 사용할 수 있습니다.

![omp TUI: DuckDuckGo에 대해 브라우저 툴을 구동하는 모습](https://omp.sh/captures/browser.webp)

### 21 · 데스크톱 자체를 제어

`computer` 툴은 실제 호스트에서 영구적인 JavaScript를 실행합니다. 윈도우와 디스플레이 열거, 스크린샷 캡처, 네이티브 입력 전송, OS 접근성 트리 탐색, 클립보드 조작이 가능합니다. 브라우저 툴이나 DOM이 아니라, 사용자가 보고 있는 바로 그 데스크톱을 제어합니다.

## 작업에 필요한 모든 것이 _이미 상자 안에 들어있습니다_.

31개의 툴이 `read` 및 `bash`와 동일한 네임스페이스에 존재합니다. `--tools read,edit,bash,…`로 활성 세트를 고정하세요. 드물게 사용되는 발견 가능한 툴들은 `xd://` 장치 뒤에 숨겨져 있습니다. `read xd://`로 목록을 확인하고, `tools.xdev`가 활성화된 경우 `write xd://<tool>`로 실행할 수 있습니다.

**파일 및 검색 (Files & search)**

- `read` — 파일, 디렉토리, 아카이브, SQLite, PDF, 노트북, URL, 원격 `ssh://` 경로 및 내부 `://` 스키마를 하나의 경로로 처리합니다.
- `write` — 파일, 아카이브 항목 또는 SQLite 행을 생성하거나 덮어씁니다.
- `edit` — 콘텐츠 해시 앵커와 오래된 앵커 복구 기능이 포함된 hashline 패치를 사용합니다.
- `ast_edit` — ast-grep을 통해 적용 전 미리보기가 가능한 구조적 재작성을 수행합니다.
- `ast_grep` — 50개 이상의 tree-sitter 문법을 통한 구조적 코드 쿼리를 수행합니다.
- `grep` — 파일, glob 및 내부 URL에 대해 정규식을 적용합니다.
- `glob` — glob 기반 경로 조회; 내용 일치가 필요할 때는 `grep`을 사용하세요.

**런타임 (Runtime)**

- `bash` — 46개의 인-프로세스 coreutils, 선택적 PTY, 백그라운드 작업 디스패치를 지원하는 워크스페이스 셸입니다.
- `eval` — 공유 프리루드와 툴 재진입이 가능한 영구적인 Python 및 JavaScript 셀입니다.

**코드 인텔리전스 (Code intelligence)**

- `lsp` — 진단, 탐색, 심볼, 이름 변경, 코드 액션, raw 요청을 처리합니다.
- `debug` — DAP 세션을 구동하여 중단점, 단계별 실행, 스레드, 스택, 변수를 제어합니다.
- `security_scan` — 네이티브 보안 리뷰를 계획하고 실행하며, Codex Security 클라우드 스캔을 구동합니다.

**조정 (Coordination)**

- `task` — 서브에이전트를 병렬로 팬아웃하며, 선택적으로 워크스페이스를 격리합니다.
- `hub` — 라이브 에이전트에게 메시지를 보내고, 백그라운드 작업을 대기/취소하며, 장기 실행 프로세스를 감독합니다.
- `todo` — 단계 추적이 포함된 세션 할 일 목록에 대해 순서가 지정된 변경을 수행합니다.
- `ask` — 대화형 실행을 위한 구조화된 후속 질문을 던집니다.

**데스크톱 및 웹 (Desktop & web)**

- `browser` — 헤드리스 Chromium 기반 Puppeteer 탭, CDP 연결 앱, 또는 릴레이를 통한 사용자 Chrome을 제어합니다.
- `computer` — 호스트 데스크톱에 대해 영구적인 JS를 실행합니다: 윈도우, 스크린샷, 네이티브 입력, AX 트리, 클립보드.
- `web_search` — 설정된 제공자 전반에 걸쳐 하나의 쿼리를 실행하고 답변과 인용구를 반환합니다.
- `github` — GitHub CLI 작업(저장소, PR, 이슈, 코드 검색, Actions 실행 감시)을 수행합니다.
- `generate_image` — Gemini, GPT, xAI Grok 이미지 모델을 통해 래스터 이미지를 생성하거나 편집합니다.
- `inspect_image` — 로컬 이미지 파일에 대해 비전 모델 분석을 수행합니다.
- `tts` — xAI Grok Voice를 통한 텍스트-음성 변환(5가지 내장 음성, WAV 또는 MP3)을 지원합니다.

**메모리 및 스킬 (Memory & skills)**

- `checkpoint` — 나중에 요약 및 보고를 위해 대화 상태를 표시합니다.
- `rewind` — 탐색적 컨텍스트를 제거하고 간결한 보고서만 유지합니다.
- `retain` — 내구성이 있는 사실을 활성 메모리 뱅크에 큐잉합니다.
- `recall` — 메모리 뱅크에서 원시 메모리를 검색합니다.
- `reflect` — 메모리 뱅크를 바탕으로 답변을 종합합니다.
- `memory_edit` — ID를 통해 저장된 메모리를 업데이트, 삭제 또는 무효화합니다.
- `learn` — 재사용 가능한 교훈을 캡처하고, 선택적으로 관리형 스킬로 승격시킵니다.
- `manage_skill` — 격리된 관리형 스킬을 생성, 업데이트 또는 삭제합니다.

설정으로 제한되며 기본적으로 꺼져 있는 툴: `github`, `security_scan`, `generate_image`, `tts`, `checkpoint`, `rewind` 및 메모리 툴(`retain`/`recall`/`reflect`/`memory_edit`, `memory.backend`에 따라 다름). `inspect_image`는 활성 모델이 이미지를 볼 수 없을 때 자동으로 활성화됩니다.

[전체 레퍼런스 →](https://omp.sh/docs/tools)

### 프롬프트 컨트롤 (Prompt controls)

세 개의 독립적인 소문자 단어를 사용하면 해당 턴이 특수한 에이전트 동작으로 전환됩니다:

- `ultrathink` — 신중한 다단계 추론과 지원되는 최고 수준의 자동 사고(thinking) 노력을 요청합니다.
- `orchestrate` — 병렬 서브에이전트를 통해 상당한 양의 독립적인 작업을 수행하고 각 단계를 검증합니다.
- `workflowz` — 활성 `task` 툴을 사용하여 결정론적인 다중 서브에이전트 워크플로우를 구축합니다.

이 단어들은 산문(prose)에서만 트리거되며, 코드 범위, 펜스 코드 블록, XML/HTML 섹션, 식별자 또는 경로 내부에서는 트리거되지 않습니다. 정확한 일치 규칙 및 설정은 [Magic keywords](docs/magic-keywords.md)를 참조하세요.

### 세션 컨트롤 (Session controls)

슬래시 명령어로 세션 전체의 실행 방식을 변경합니다:

- `/vibe` — [Vibe 모드](docs/vibe-mode.md) 진입: `read` 전용 툴셋을 가진 `fast`/`good` 워커 세션을 구동하는 디렉터 역할을 수행합니다.
- `/fresh` — 로컬 트랜스크립트를 변경하지 않고 제공자 스트림 상태(오래된 프롬프트 캐시, 엉킨 스트림)를 리셋합니다. [세션 작업](docs/session-operations-export-share-fork-resume.md#fresh)을 참조하세요.

## 60개 이상의 제공자, 수천 개의 모델, _/model 명령어 하나로 해결_.

10가지 역할이 의도에 따라 작업을 라우팅합니다. 일반적인 턴에는 `default`. 저렴한 서브에이전트 팬아웃에는 `smol`. 깊은 추론에는 `slow`. 계획 모드에는 `plan`. 변경 로그 작성에는 `commit`. 그 외 `vision`, `designer`, `task`, `advisor`, `tiny` 역할이 있습니다. 실행 시 `--smol`, `--slow`, 또는 `--plan`으로 오버라이드하거나, `Ctrl+P`로 활성 역할에 설정된 모델들을 순환할 수 있습니다. 세션 중간에 `/model` 슬래시 명령어로 활성 모델을 교체하세요.

인증 태그 안내: `oauth`는 제공자 계정으로 로그인하며, `plan`은 코딩 플랜 구독을 통해 라우팅되고, `local`은 키가 선택 사항인 로컬 서버에서 실행됩니다.

### 프런티어 API (Frontier APIs)

직접 API 및 게이트웨이입니다. 역할별로 제공자를 혼합할 수 있습니다.

Anthropic `oauth` · OpenAI · OpenAI Codex `oauth` · Google Gemini · Google Vertex · Google Antigravity `oauth` · xAI · SuperGrok `oauth` · DeepSeek · Mistral · Groq · Cerebras · Fireworks · Together · Baseten · Hugging Face · NVIDIA · Meta · Amazon Bedrock · Azure OpenAI · SiliconFlow · GMI Cloud · CoreWeave · Sakana AI · OpenRouter · Synthetic · Vercel AI Gateway · Cloudflare AI Gateway · Wafer Serverless

### 코딩 플랜 (Coding plans)

구독 기반 라우팅입니다. `/login`으로 세션을 연결합니다.

Cursor `oauth` · GitHub Copilot `oauth` · GitLab Duo · Devin `oauth` · Kimi Code `plan` · Moonshot · MiniMax Coding Plan `plan` · MiniMax Coding Plan CN `plan` · Alibaba Coding Plan `plan` · Qwen Portal `oauth` · Z.AI / GLM Coding Plan `plan` · Zhipu Coding Plan `plan` · Xiaomi MiMo · Qianfan · Umans `plan` · NanoGPT · Novita · Venice · Kilo · ZenMux · OpenCode Go · OpenCode Zen

### 직접 실행 (Run it yourself)

OpenAI 호환 `/v1/models`를 지원합니다. 로컬 인스턴스는 키를 생략합니다.

Ollama `local` · Ollama Cloud · LM Studio `local` · llama.cpp `local` · vLLM `local` · LiteLLM

### 커스텀 OpenAI 호환 제공자

`~/.omp/agent/models.yml`에 커스텀 제공자를 정의하세요:

```yaml
providers:
  spark:
    baseUrl: http://192.168.10.223:8000/v1
    api: openai-completions
    apiKey: dummy
    models:
      - id: minimax-m3
        name: MiniMax M3
        contextWindow: 100000
        maxTokens: 32000
```

`omp models spark`를 실행하여 인식을 확인하세요. 그 다음 `omp setup`을 실행해 기본 모델 단계에서 선택하거나, 세션에서 `/model`을 열어 `default` 역할에 할당하세요.

피커 없이 기본값을 미리 설정하려면 `~/.omp/agent/config.yml`에 선택자를 추가하세요:

```yaml
modelRoles:
  default: spark/minimax-m3
```

### 라우팅을 유용하게 만드는 4가지 설정

- **커스텀 제공자** — `openai-completions`, `openai-responses`, `openai-codex-responses`, `azure-openai-responses`, `anthropic-messages`, `bedrock-converse-stream`, `google-generative-ai`, `google-gemini-cli`, 또는 `google-vertex`를 지원하는 모든 서비스를 `~/.omp/agent/models.yml`에 선언할 수 있습니다.
- **폴백 체인 (Fallback chains)** — `retry.fallbackChains` 하위에 역할별 또는 모델별 체인을 설정합니다. 기본 제공자가 429 에러를 내거나 쿼타 제한에 도달하면, 다음 항목이 턴의 남은 부분을 처리하며, 쿨다운 후 복구됩니다.
- **경로 범위 모델 (Path-scoped models)** — `enabledModels` 및 `disabledProviders` 항목에 `path:` 접두사를 붙여 글로벌 설정 변경 없이 특정 저장소에만 다른 모델 세트를 고정할 수 있습니다. 범위 지정 항목은 해당 경로와 그 하위의 모든 경로에 적용됩니다.
- **라운드 로빈 인증 정보 (Round-robin credentials)** — 제공자별로 API 키를 쌓아두면 런타임이 세션 어피니티(affinity)와 인증 정보별 백오프(backoff)를 적용해 순환 사용합니다. 하나의 키가 점심시간 전에 쿼타를 다 써버릴 때 유용합니다.

전체 제공자 및 라우팅 레퍼런스는 [omp.sh/docs/providers](https://omp.sh/docs/providers)에서 확인하세요.

## 23개의 백엔드. _에이전트가 이미 알고 있는 단 하나의 툴_.

`web_search`는 외부 모듈을 붙인 것이 아니라 내장 기능입니다. `auto`는 23개의 제공자 체인을 탐색하며, 이미 유료 결제 중인 제공자가 있다면 이름으로 고정할 수 있습니다. 모든 검색 결과 뒤에는 사이트 인식 추출 기능이 작동하여 GitHub, 레지스트리, arXiv, Stack Overflow, 문서를 구조화된 마크다운으로 변환하며, 앵커와 링크 타겟이 그대로 유지됩니다.

### 검색 제공자 (Search providers)

23개의 백엔드가 있습니다. 하나를 고정하거나 `auto`가 순서대로 체인을 탐색하게 하세요.

| 제공자     | 인증                                      |
| ------------ | ----------------------------------------- |
| `auto`       | 체인                                     |
| `perplexity` | `PERPLEXITY_API_KEY` (익명 폴백) |
| `gemini`     | oauth                                     |
| `anthropic`  | oauth                                     |
| `codex`      | oauth                                     |
| `xai`        | oauth 또는 `XAI_API_KEY`                    |
| `zai`        | `ZAI_API_KEY`                             |
| `exa`        | `EXA_API_KEY` (또는 mcp)                    |
| `tinyfish`   | `TINYFISH_API_KEY`                        |
| `jina`       | `JINA_API_KEY`                            |
| `kagi`       | `KAGI_API_KEY`                            |
| `tavily`     | `TAVILY_API_KEY`                          |
| `firecrawl`  | `FIRECRAWL_API_KEY` (키리스 폴백)    |
| `brave`      | `BRAVE_API_KEY`                           |
| `kimi`       | `/login kimi-code` 또는 검색 키          |
| `parallel`   | `PARALLEL_API_KEY`                        |
| `synthetic`  | `SYNTHETIC_API_KEY`                       |
| `searxng`    | 자체 호스팅                               |
| `duckduckgo` | 키 필요 없음                                    |
| `startpage`  | 키 필요 없음                                    |
| `google`     | 키 필요 없음 (브라우저)                          |
| `ecosia`     | 키 필요 없음 (브라우저)                          |
| `mojeek`     | 키 필요 없음 (브라우저)                          |
| `public`     | 키 필요 없음 (위의 모든 항목 통합)   |

Exa는 `/login exa`를 통해 저장된 API 키를 사용할 수도 있으며, 명시적으로 키 없이 선택하면 공용 MCP 폴백을 사용합니다.

### 특화 핸들러 (Specialised handlers)

에이전트는 단순 제거된 HTML이 아니라 구조화된 콘텐츠를 받습니다.

- **코드 호스트** — github, gitlab
- **패키지 레지스트리** — npm, PyPI, crates.io, Hex, Hackage, NuGet, Maven, RubyGems, Packagist, pub.dev, Go packages
- **연구 소스** — arxiv, semantic scholar
- **포럼** — stack overflow, reddit, hn
- **문서** — mdn, readthedocs, docs.rs

페이지는 링크 구조가 유지된 채 마크다운으로 변환됩니다. 에이전트는 앵커를 잃지 않고 인용하고, 따라가고, 쿼트할 수 있습니다.

### 보안 데이터베이스 (Security databases)

취약점 조회는 블로그 요약이 아닌 벤더 데이터를 통해 답변합니다.

- **NVD** — 국가 취약점 데이터베이스 (National Vulnerability Database)
- **OSV** — 오픈 소스 취약점 피드 (Open Source Vuln feed)
- **CISA KEV** — 알려진 악용 취약점 (Known Exploited Vulns)

[`web_search` 레퍼런스 ↗](https://omp.sh/docs/tools#web_search)

## 다른 하네스들이 셸 호출로 처리하는 작업을 수행하는 **약 80,000 라인**의 Rust 코드.

9개의 crate와 하나의 플랫폼 태그 N-API 애드온으로 구성됩니다. 검색, 셸, AST, 하이라이트, PTY, 데스크톱 제어, 이미지 디코드, BPE 카운팅 등이 모두 libuv 풀의 인-프로세스에서 실행됩니다. 핫 패스(hot path)에서 fork/exec이 발생하지 않습니다. 또한 vendored 된 약 77k 라인의 코드가 포함되어 있습니다: `brush` bash 포크, `jaq` (jq 엔진), 그리고 셸에 직접 컴파일되어 인-프로세스 내장 함수로 실행되는 46개의 uutils coreutils(`ls`, `sed`, `sort`, `xargs` 등)입니다.

- Crates: `pi-natives`, `pi-shell`, `pi-ast`, `pi-iso`, `pi-voice`, `pi-walker`, `pi-uu-grep`, `pi-uu-diff`, `pi-uutils-ctx`
- 플랫폼: `linux-x64`, `linux-arm64`, `darwin-x64`, `darwin-arm64`, `win32-x64` — x64는 AVX2 및 베이스라인 바이너리를 모두 제공합니다.

Crate별 코드 라인 수(코드만 집계):

| Crate         | 설명                                                                           |   ~LoC |
| ------------- | -------------------------------------------------------------------------------------- | -----: |
| pi-shell      | 임베디드 bash 엔진 · 영구 세션 · 인-프로세스 coreutils 디스패치 · 미니마이저 | 38,000 |
| pi-natives    | N-API 표면 — 아래 표의 모든 모듈                                    | 25,000 |
| pi-walker     | 병렬 ignore-aware 워커 + grep · glob · workspace · shell이 공유하는 스캔 캐시    |  5,200 |
| pi-iso        | 워크스페이스 격리 · apfs · btrfs · zfs · reflink · overlayfs · projfs · rcopy        |  3,300 |
| pi-uu-grep    | ripgrep 기반 grep, 인-프로세스 셸 내장 함수로 실행                                |  3,300 |
| pi-ast        | tree-sitter + ast-grep 매칭, 블록 분석, 구조적 요약                |  2,900 |
| pi-voice      | 오디오 캡처/재생 · Opus · 라이브 WebRTC                                            |  1,000 |
| pi-uu-diff    | similar crate 기반의 구조화된 diff 내장 함수                                                 |    500 |
| pi-uutils-ctx | 스레드 로컬 stdio/cwd/env를 통해 fork 없이 내장 함수 병렬 실행                          |    300 |

`pi-natives` 내부의 모듈별 상세 내역 (글루 코드 및 테스트 제외):

| 모듈        | 설명                                                                      | 기반 기술                                |   ~LoC |
| ------------- | --------------------------------------------------------------------------------- | ----------------------------------------- | -----: |
| desktop       | 윈도우/디스플레이 열거 · 스크린샷 · 네이티브 입력 · `computer`용 AX 트리   | xcap · enigo · OS AX FFI                  | 10,600 |
| grep          | 정규식 검색 · 병렬/순차 · glob 및 타입 필터 · 퍼지 검색             | grep-regex · grep-searcher                |  3,280 |
| text          | ANSI 인식 너비 · 절단 · 컬럼 슬라이싱 · SGR 유지 랩핑              | unicode-width · segmentation              |  2,070 |
| snapcompact   | 컨텍스트 압축을 위한 비트맵 프레임 래스터화 + PNG 인코딩                   | image · png                               |  1,760 |
| keys          | xterm 폴백이 포함된 Kitty 키보드 프로토콜 · PHF 완벽 해시 조회             | phf                                       |  1,740 |
| ast           | ast-grep 패턴 매칭 및 구조적 재작성                                 | ast-grep-core                             |  1,510 |
| diff          | 툴 및 미리보기를 위한 구조화된 파일 diffing                                    | in-tree                                   |  1,030 |
| pty           | sudo · ssh 대화형 프롬프트를 위한 네이티브 PTY 할당                          | portable-pty                              |    630 |
| crash_handler | 네이티브 크래시 캡처 및 보고                                                | in-tree                                   |    610 |
| highlight     | 구문 하이라이팅 · 11개 시맨틱 카테고리 · 30개 이상의 별칭                        | syntect                                   |    550 |
| appearance    | Mode 2031 + CoreFoundation FFI를 통한 네이티브 macOS 다크/라이트 모드                        | core-foundation                           |    450 |
| task          | libuv 스레드 풀에서의 블로킹 작업 · 취소 · 타임아웃 · 프로파일링           | tokio · napi                              |    440 |
| glob          | glob 기반 탐색 · 타입 필터 · mtime 정렬 · gitignore 준수               | ignore · globset                          |    430 |
| fd            | find-tool 대체용 파일 시스템 워커                                       | ignore                                    |    385 |
| clipboard     | 시스템 클립보드에서 텍스트 복사 및 이미지 읽기 · xclip/pbcopy 불필요                  | arboard                                   |    370 |
| workspace     | gitignore + AGENTS.md 발견을 한 번에 수행하는 워크스페이스 워커                 | ignore                                    |    275 |
| power         | 유휴/시스템/디스플레이 절전 방지를 위한 macOS power-assertion API                | IOKit FFI                                 |    270 |
| prof          | 폴디드 스택 및 SVG 플레임그래프 출력을 지원하는 순환 버퍼 프로파일러              | inferno                                   |    240 |
| file_lock     | 프로세스 간 권고 파일 잠금 (Advisory file locking)                                               | in-tree                                   |    210 |
| ps            | 크로스 플랫폼 프로세스 트리 킬 및 후손 목록 나열                           | libc · libproc · CreateToolhelp32Snapshot |    195 |
| tokens        | O200k / Cl100k BPE 토큰 카운팅 · 두 테이블 모두 내장                          | tiktoken-rs                               |     70 |
| html          | 선택적 콘텐츠 정리가 포함된 HTML-to-Markdown 변환                                   | html-to-markdown-rs                       |     60 |
| sixel         | 터미널 이미지 렌더링 · PNG · JPEG · WebP · GIF 디코드 · 리사이즈 · SIXEL 인코드 | icy_sixel · image                         |     55 |

## 네 가지 진입점: _대화형_, _원샷_, RPC, 그리고 ACP.

동일한 엔진을 네 가지 래퍼로 제공합니다. `omp`는 TUI를 실행합니다. `omp -p`는 단일 프롬프트에 답하고 종료합니다. Node SDK는 세션을 프로세스에 직접 내장합니다. `omp --mode rpc`와 `omp acp`는 stdio를 통해 다른 프로그램에 제어권을 넘깁니다.

### 대화형 (Interactive) — 확신이 없을 때 에이전트가 질문합니다

TUI가 기본 인터페이스입니다. 툴 호출은 카드로 렌더링되고, 편집 내용은 적용 전 미리보기가 제공되며, 모호한 상황은 `ask` 툴을 통해 해결됩니다. `ask`는 에이전트가 턴 중간에 호출할 수 있는 구조화된 옵션 선택기입니다. 나머지는 키보드로 조작합니다.

동일한 프롬프트 카드가 ACP를 통해서도 제공되므로, 에디터는 직접 구현할 필요 없이 선택기를 사용할 수 있습니다.

![omp TUI: ask 툴이 세 가지 선택지와 첫 번째 옵션에 (Recommended) 배지를, 하단에 'up/down navigate · enter select · esc cancel' 안내가 포함된 옵션 선택기를 렌더링하는 모습.](https://omp.sh/captures/ask.webp)

### SDK — Node에 내장

`@oh-my-pi/pi-coding-agent`

Node 및 TypeScript 호스트는 엔진을 직접 가져와 사용할 수 있습니다. 패키지는 `ModelRegistry`, `SessionManager`, `createAgentSession`, `discoverAuthStorage`를 노출하며, 세션은 구독 가능한 타입화된 이벤트를 발행합니다.

```ts
import {
  ModelRegistry,
  SessionManager,
  createAgentSession,
  discoverAuthStorage,
} from "@oh-my-pi/pi-coding-agent";

const auth = await discoverAuthStorage();
const models = new ModelRegistry(auth);
await models.refresh();

const { session } = await createAgentSession({
  sessionManager: SessionManager.inMemory(),
  authStorage: auth,
  modelRegistry: models,
});
await session.prompt("list .ts files");
```

### RPC — stdio를 통한 제어

`omp --mode rpc`

Node 외의 언어로 내장하거나 프로세스 격리가 필요할 때 사용합니다. NDJSON 명령어를 입력하고 응답 및 이벤트 프레임을 출력합니다. `--mode rpc-ui`를 사용하면 툴 카드, 선택기, 다이얼로그가 `extension_ui_request` 프레임으로 전송되며, 호스트가 이에 응답해야 합니다.

```
$ omp --mode rpc --no-session
> {"id":"r1","type":"prompt","message":"list .ts files"}
< {"id":"r1","type":"response", ...}
> {"id":"r2","type":"set_model","provider":"anthropic","modelId":"sonnet-4.5"}
> {"id":"r3","type":"abort"}
```

### ACP — 에디터와의 통신

`omp acp`

JSON-RPC 기반의 [Agent Client Protocol](https://github.com/zed-industries/agent-client-protocol)입니다. 에디터가 기능을 광고하면 툴 I/O가 에디터를 통해 라우팅되며, 쓰기 작업은 `session/request_permission`에 의해 제어됩니다.

| omp 툴     | ACP 경로                           |
| ------------ | ----------------------------------- |
| `bash`       | `terminal/create + terminal/output` |
| `read`       | `fs/read_text_file`                 |
| `write`      | `fs/write_text_file`                |
| `edit, bash` | `session/request_permission`        |

전체 레퍼런스: [omp.sh/docs/sdk](https://omp.sh/docs/sdk).

## 성장해도 충분한 하네스는 _한계를 느끼지 않는_ 하네스입니다.

**[omp.sh](https://omp.sh)**에서 시작하세요.

`omp`는 [Mario Zechner](https://github.com/mariozechner)의 [Pi](https://github.com/badlogic/pi-mono)를 포크하여 코딩 중심의 인터페이스로 다시 쓴 프로젝트입니다. 세션, 서브에이전트, 슬래시 명령어, 확장 기능 등이 모두 TypeScript로 작성되었으며, MIT 라이선스로 [GitHub](https://github.com/can1357/oh-my-pi)에 공개되어 있습니다. 설정으로 모양을 잡고, 외부에서 훅을 걸거나, 필요할 때 소스 코드를 읽으세요.

### 기본 요소 (Primitives)

확장 기능은 TypeScript 모듈입니다. 내장 기능이 사용하는 것과 동일한 툴 API, 슬래시 명령어 레지스트리, 단축키 테이블, TUI 프리미티브를 사용합니다. 예약된 영역은 없습니다.

### 발견 (Discovery)

첫 실행 시 `omp`는 디스크에 이미 존재하는 모든 것을 상속합니다: `.claude`, `.cursor`, `.windsurf`, `.gemini`, `.codex`, `.cline`, `.github/copilot`, `.vscode`의 규칙, 스킬, MCP 서버 등이 포함됩니다. 마이그레이션 스크립트가 필요 없습니다.

### 확장성 (Extensibility)

부족한 기능이 있다면 `omp`에게 직접 작성하게 한 뒤 `/reload-plugins`를 실행하세요. 로컬에 유지하거나, `marketplace`를 통해 배포하거나, npm에 게시할 수 있습니다.

## 철학

`omp`는 [Mario Zechner](https://github.com/mariozechner)의 [pi-mono](https://github.com/badlogic/pi-mono)를 포크하여 모든 기능이 내장된 코딩 워크플로우를 확장한 프로젝트입니다.

핵심 아이디어:

- 실제 코딩 작업을 위해 인터랙티브한 터미널 우선 UX를 유지합니다.
- 실용적인 내장 기능(툴, 세션, 브랜칭, 서브에이전트, 확장성)을 포함합니다.
- 고급 동작을 숨기지 않고 설정 가능하게 만듭니다.

---

## 개발 (Development)

### 소스에서 시작하기

새로 클론한 경우, 소스 CLI를 시작하기 전에 워크스페이스 의존성과 로컬 Rust/N-API 애드온이 모두 필요합니다.

```sh
bun setup
bun dev
```

`bun setup`은 Bun 워크스페이스를 설치하고 `@oh-my-pi/pi-natives`를 빌드합니다. Rust crate나 `packages/natives`를 변경한 후에는 `bun run build:native`를 다시 실행하세요.

비대화형 스모크 테스트:

```sh
bun dev -- --version
```

### 디버그 명령어

`/debug`는 디버깅, 보고, 프로파일링을 위한 툴을 엽니다.

아키텍처 및 기여 가이드라인은 [packages/coding-agent/DEVELOPMENT.md](packages/coding-agent/DEVELOPMENT.md)를 참조하세요.

---

## 모노레포 패키지 (Monorepo Packages)

| 패키지                                                                       | 설명                                                                 |
| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| **[@oh-my-pi/collab-web](packages/collab-web)**                               | 협업 라이브 세션을 위한 브라우저 게스트 클라이언트, 모의 호스트 및 로컬 릴레이   |
| **[@oh-my-pi/pi-ai](packages/ai)**                                            | 스트리밍 및 모델/제공자 통합 기능이 포함된 멀티 제공자 LLM 클라이언트     |
| **[@oh-my-pi/pi-catalog](packages/catalog)**                                  | 모델 카탈로그: 번들된 모델 데이터베이스, 제공자 기술서 및 식별 정보   |
| **[@oh-my-pi/pi-agent-core](packages/agent)**                                 | 툴 호출 및 상태 관리가 포함된 에이전트 런타임                        |
| **[@oh-my-pi/pi-coding-agent](packages/coding-agent)**                        | 인터랙티브 코딩 에이전트 CLI 및 SDK                                        |
| **[@oh-my-pi/pi-tui](packages/tui)**                                          | 차분 렌더링(differential rendering)을 지원하는 터미널 UI 라이브러리                             |
| **[@oh-my-pi/pi-natives](packages/natives)**                                  | grep, 셸, 이미지, 텍스트, 구문 하이라이팅 등을 위한 N-API 바인딩  |
| **[@oh-my-pi/omp-stats](packages/stats)**                                     | AI 사용 통계를 위한 로컬 관찰성 대시보드                       |
| **[@oh-my-pi/omptype](packages/omptype)**                                     | 지연 JIT 컴파일을 지원하는 ArkType 호환 스키마 검증              |
| **[@oh-my-pi/pi-utils](packages/utils)**                                      | 공유 유틸리티 (로깅, 스트림, 디렉토리/환경/프로세스 헬퍼)               |
| **[@oh-my-pi/pi-wire](packages/wire)**                                        | 공유 협업 라이브 세션 프로토콜 타입 및 릴레이 상수               |
| **[@oh-my-pi/hashline](packages/hashline)**                                   | `edit` 툴의 기반이 되는 라인 앵커 패치 언어 및 적용기             |
| **[@oh-my-pi/pi-mnemopi](packages/mnemopi)**                                  | Oh My Pi 에이전트를 위한 로컬 SQLite 메모리 엔진                              |
| **[@oh-my-pi/snapcompact](packages/snapcompact)**                             | 비트맵 프레임 컨텍스트 압축 패키지 및 SQuAD 평가 세트               |
| **[@oh-my-pi/browser-relay](packages/browser-relay)**                         | 브라우저 툴이 기존 탭을 제어할 수 있게 해주는 Chrome 확장 프로그램        |
| **[@oh-my-pi/pi-metaharness](packages/metaharness)**                          | 통합 벤치마크 러너, Harbor 실행 저장소, REST/SSE API, 라이브 대시보드 |
| **[@oh-my-pi/typescript-edit-benchmark](packages/typescript-edit-benchmark)** | TypeScript 소스 변이를 기반으로 구축된 편집 벤치마크 세트                   |

### Rust Crates

| Crate                                              | 설명                                                                                         |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **[pi-natives](crates/pi-natives)**                | `@oh-my-pi/pi-natives`에서 사용하는 핵심 Rust 네이티브 애드온 (N-API `cdylib`); 아래 crate들을 통합함 |
| **[pi-shell](crates/pi-shell)**                    | `pi-natives`에서 분리된 임베디드 셸 / PTY / 프로세스 관리 (`brush-*` 래핑)               |
| **[pi-ast](crates/pi-ast)**                        | tree-sitter 기반 코드 요약 및 AST 유틸리티 (50개 이상의 언어 문법)                         |
| **[pi-iso](crates/pi-iso)**                        | 작업 격리 백엔드 리졸버: APFS clones, btrfs/zfs reflinks, overlayfs, projfs, rcopy          |
| **[pi-voice](crates/pi-voice)**                    | 오디오 캡처/재생, Opus 코덱 및 라이브 WebRTC 스트리밍 프리미티브                           |
| **[pi-walker](crates/pi-walker)**                  | grep, glob, workspace가 공유하는 스캔 캐시를 가진 병렬 ignore-aware 파일 시스템 워커     |
| **[pi-uu-grep](crates/pi-uu-grep)**                | 인-프로세스 셸 내장 함수로 실행되는 ripgrep-library 기반 grep                                 |
| **[pi-uu-diff](crates/pi-uu-diff)**                | similar crate 기반의 구조화된 diff 내장 함수                                                 |
| **[pi-uutils-ctx](crates/pi-uutils-ctx)**          | 인-프로세스 내장 함수가 병렬로 실행될 수 있도록 하는 스레드 로컬 stdio/cwd/env 컨텍스트                          |
| **[brush-core](crates/vendor/brush-core)**         | 임베디드 bash 실행을 위해 vendored 된 [brush-shell](https://github.com/reubeno/brush) 포크        |
| **[brush-builtins](crates/vendor/brush-builtins)** | vendored bash 내장 함수 (cd, echo, test, printf, read, export 등)                                 |
| **[jaq](crates/vendor/jaq)**                       | 인-프로세스 내장 함수로 실행되는 vendored jq 호환 JSON 쿼리 엔진                              |
| **uu-\* family** ([crates/vendor](crates/vendor))  | fork/exec 없이 인-프로세스로 실행되는 46개의 vendored uutils coreutils (ls, sed, sort, xargs, …)            |

## 기여하기 (Contributing)

이슈와 Pull request는 모두에게 열려 있습니다. 현재 오픈 PR은 **테스트 기간**이며, 진행 상황을 평가하는 동안 이전의 추천(vouch) 요구 사항이 해제되었습니다. 추후 다시 도입될 수 있습니다. 기여 가이드라인은 **[CONTRIBUTING.md](CONTRIBUTING.md)**를 참조하세요.

---

## 라이선스 (License)

MIT. [LICENSE](LICENSE)를 참조하세요.

_항상 켜져 있는 터미널을 위해 만들어졌습니다_

- [omp.sh](https://omp.sh)
- [GitHub](https://github.com/can1357/oh-my-pi)
- [Changelog](https://github.com/can1357/oh-my-pi/blob/main/packages/coding-agent/CHANGELOG.md)
- [npm](https://www.npmjs.com/package/@oh-my-pi/pi-coding-agent)
- [Discord](https://discord.gg/4NMW9cdXZa)
- [MIT](https://github.com/can1357/oh-my-pi/blob/main/LICENSE)

oh-my-pi

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README