핵심 요약
OpenHarness는 터미널 환경에서 작동하는 오픈소스 AI 코딩 에이전트로, 특정 LLM 제공업체에 종속되지 않는 유연한 아키텍처를 제공한다. 사용자는 Ollama를 통해 자신의 하드웨어에서 무료로 로컬 모델을 실행하거나, OpenAI 및 Anthropic 등의 클라우드 API를 연결하여 고성능 추론을 수행할 수 있다. 17가지의 도구와 16가지 슬래시 명령어를 통해 파일 편집, 셸 명령어 실행, 웹 검색 등의 작업을 수행하며, 모든 변경 사항은 Git에 자동 커밋되어 안전한 롤백이 가능하다. 특히 헤드리스 모드를 지원하여 CI/CD 파이프라인 내에서 자동화된 코드 수정 및 테스트 작업을 수행하는 데 최적화되어 있다.
배경
Node.js 18 이상, Git 설치 및 초기화된 저장소, Ollama (로컬 모델 사용 시) 또는 LLM API 키 (클라우드 사용 시)
대상 독자
터미널 환경을 선호하고 로컬 LLM 또는 다양한 API를 활용해 코딩 생산성을 높이려는 개발자
의미 / 영향
OpenHarness는 고가의 구독형 AI 코딩 도구에 대한 강력한 오픈소스 대안을 제시한다. 특히 로컬 LLM 지원과 Git 기반의 안전 장치는 기업 내부의 보안 가이드라인을 준수하면서도 AI 에이전트를 도입하려는 팀에게 실질적인 해결책이 될 수 있다.
섹션별 상세
npm install -g @zhijiewang/openharness
ohOpenHarness를 전역 설치하고 실행하여 로컬 Ollama 모델을 자동 감지하는 과정
oh --model ollama/qwen2.5:7b # 특정 로컬 모델 실행
oh --model gpt-4o # 클라우드 모델 실행 (API 키 필요)로컬 모델과 클라우드 모델을 선택하여 실행하는 명령어 예시
oh run "fix the tests" --json # CI/CD를 위한 헤드리스 모드 실행대화형 UI 없이 특정 작업을 수행하고 결과를 JSON으로 출력하는 방법
실무 Takeaway
- 보안이나 비용 문제로 클라우드 LLM 사용이 제한적인 환경이라면 Ollama와 OpenHarness를 결합하여 로컬 인프라 기반의 무료 AI 코딩 환경을 구축할 수 있다.
- 프로젝트 루트에 `.oh/RULES.md` 파일을 생성하여 '테스트 코드 필수 작성'이나 '특정 라이브러리 사용 금지'와 같은 프로젝트 전용 규칙을 에이전트에게 강제할 수 있다.
- 복잡한 리팩터링 시 `/undo` 기능을 활용하면 AI의 잘못된 접근을 즉시 롤백할 수 있어 Git 히스토리를 깨끗하게 유지하면서 AI와 협업이 가능하다.
언급된 리소스
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.