도구
도구
Oh My OpenAgent는 에이전트에게 세계적 수준의 도구를 제공합니다. LSP, AST-Grep, Tmux, MCP — 임시로 연결한 것이 아니라 실제로 통합되어 있습니다.
Hashline (Hash-Anchored Edit Tool)
하네스 문제는 현실입니다. 대부분의 에이전트 실패는 모델 때문이 아니라 편집 도구 때문입니다.
“이러한 도구 중 어느 것도 모델에게 변경하려는 줄에 대한 안정적이고 검증 가능한 식별자를 제공하지 않습니다… 모두 모델이 이미 본 콘텐츠를 재현하도록 의존합니다. 할 수 없을 때 — 그리고 자주 할 수 없습니다 — 사용자는 모델을 탓합니다.”
oh-my-pi에서 영감을 받은 Hashline은 모든 줄에 콘텐츠 해시 태그를 지정합니다:
11#VK| function hello() {
22#XJ| return "world";
33#MB| }에이전트는 이러한 태그를 참조하여 편집합니다. 마지막 읽기 이후 파일이 변경된 경우 해시가 일치하지 않아 편집이 손상 전에 거부됩니다. 공백 재현 없음. 오래된 줄 오류 없음.
효과: Grok Code Fast 1 성공률이 **6.7% → 68.3%**로 향상되었습니다 — 편집 도구만 변경했을 뿐입니다.
IntentGate
분류나 행동 전에 사용자의 실제 의도를 분석합니다. 더 이상 문자 그대로의 오해석이 없습니다.
요청을 입력하면 IntentGate가:
- 실제로 의미하는 바를 파싱합니다 (단순히 말한 것만이 아닌)
- 작업 유형을 분류합니다
- 적절한 에이전트로 라우팅합니다
이를 통해 에이전트가 지시를 너무 문자 그대로 받아들여 예상치 못한 결과를 생성하는 것을 방지합니다.
LSP 도구
모든 에이전트를 위한 IDE 수준 정밀도:
| 도구 | 설명 |
|---|---|
lsp_rename | 안전한 교차 파일 심볼 이름 변경 |
lsp_goto_definition | 심볼 정의로 이동 |
lsp_find_references | 심볼의 모든 참조 찾기 |
lsp_diagnostics | 빌드 전 진단 검사 |
이 도구들은 에이전트에게 IDE가 제공하는 것과 동일한 코드 인텔리전스를 제공합니다 — 타입 안전 리팩토링, 정확한 네비게이션, 실시간 오류 감지.
AST-Grep
25개 언어에서 패턴 인식 코드 검색 및 리라이트.
텍스트 기반 검색과 달리 AST-Grep은 코드 구조를 이해합니다:
- 문자열 매칭이 아닌 구문 패턴으로 검색
- 구조를 보존하면서 코드 리라이트
- TypeScript, Python, Go, Rust, Java 등 20개 이상의 언어 지원
예시 패턴:
useState를 사용하는 모든 React 컴포넌트 찾기- 오류 처리가 없는 모든 비동기 함수 찾기
- 더 이상 사용되지 않는 API 호출 일괄 교체
Tmux 통합
완전한 대화형 터미널. REPL, 디버거, TUI 앱. 에이전트가 세션을 유지합니다.
Tmux가 가능하게 하는 것:
- 장기 실행 프로세스 실행 (개발 서버, 테스트 워처)
- REPL과 상호작용 (Node.js, Python, IRB)
- 디버거 사용 (gdb, pdb, node —inspect)
- TUI 애플리케이션 실행 (vim, htop, lazygit)
- 에이전트가 상호작용 간에 세션 상태 유지
Skill-Embedded MCP
MCP 서버는 컨텍스트 예산을 많이 소모합니다. Oh My OpenAgent가 이를 해결했습니다.
스킬이 자체 MCP 서버를 가져옵니다:
- 온디맨드 실행 — 스킬이 활성화될 때만
- 작업 범위 제한 — 관련 도구만 노출
- 완료 후 제거 — 컨텍스트 윈도우가 깨끗하게 유지
내장 스킬
| 스킬 | 설명 |
|---|---|
playwright | 브라우저 자동화 — 스크린샷, E2E 테스트, 웹 스크래핑 |
git-master | 원자적 커밋, 리베이스 수술, 깔끔한 git 히스토리 |
frontend-ui-ux | 디자인 우선 UI 구현 |
커스텀 스킬
나만의 스킬을 추가하세요:
- 프로젝트 수준:
.opencode/skills/*/SKILL.md - 사용자 수준:
~/.config/opencode/skills/*/SKILL.md
각 스킬에는 다음이 포함됩니다:
- 도메인 튜닝된 시스템 지침
- 내장 MCP 서버 정의
- 범위가 지정된 권한
내장 MCP
세 가지 MCP 서버가 항상 활성화되어 있습니다:
| MCP | 기반 | 설명 |
|---|---|---|
websearch | Exa | 웹 검색 — 관련 코드, 문서, 솔루션 찾기 |
context7 | Context7 | 공식 문서 조회 — 라이브러리 문서를 컨텍스트로 가져오기 |
grep_app | Grep.app | GitHub 코드 검색 — 공개 저장소 전체 검색 |
기본적으로 구성되어 있으며 설정이 필요 없습니다. 에이전트에게 웹 정보, 문서, 코드 검색에 대한 실시간 액세스를 제공합니다.