OpenHarness: 로컬 및 클라우드 LLM을 지원하는 터미널 기반 오픈소스 AI 코딩 에이전트

섹션별 상세

기존 AI 에이전트들이 특정 모델에 종속되거나 고가의 구독료를 요구하는 문제를 해결하기 위해 다양한 LLM 백엔드를 지원한다. Ollama를 통한 로컬 실행은 물론 OpenAI, Anthropic, OpenRouter 등 다양한 API를 사용자가 직접 선택하여 비용과 성능을 최적화할 수 있다. 로컬 모델 사용 시 별도의 API 비용 없이 완전 무료로 에이전트를 운영하는 것이 가능하다.

bash

npm install -g @zhijiewang/openharness
oh

OpenHarness를 전역 설치하고 실행하여 로컬 Ollama 모델을 자동 감지하는 과정

bash

oh --model ollama/qwen2.5:7b # 특정 로컬 모델 실행
oh --model gpt-4o # 클라우드 모델 실행 (API 키 필요)

로컬 모델과 클라우드 모델을 선택하여 실행하는 명령어 예시

근거

OpenHarness는 Ollama를 통한 로컬 모델과 OpenAI, Anthropic 등 다양한 클라우드 API를 모두 지원한다. — Providers 섹션 및 Why OpenHarness? 비교표

AI의 코드 수정 과정에서 발생할 수 있는 위험을 방지하기 위해 강력한 Git 통합 기능을 핵심으로 설계했다. AI가 파일을 수정하기 전후로 자동 커밋을 생성하며, 사용자는 `/undo` 명령어로 AI의 수정을 즉시 되돌리거나 `/diff`로 변경 사항을 검토할 수 있다. 이러한 구조는 사용자의 기존 작업 내역과 AI의 수정 내역을 명확히 분리하여 관리한다.

근거

AI의 모든 파일 변경 사항은 자동으로 Git에 커밋되며 /undo 명령어로 되돌릴 수 있다. — Git Integration 섹션

터미널 환경에서의 효율적인 상호작용을 위해 17개의 도구와 16개의 슬래시 명령어를 제공한다. Bash 명령어 실행, 파일 읽기/쓰기, 정규표현식 검색, 웹 페이지 내용 추출 등 개발에 필요한 핵심 기능을 도구 형태로 갖추고 있다. 세션 도중 `/model` 명령어를 통해 실시간으로 LLM을 교체하며 작업의 난이도에 맞는 모델을 선택할 수 있다.

근거

Bash 실행, 파일 편집, 웹 검색 등 총 17개의 도구를 제공한다. — Tools (17) 목록 표

자동화된 워크플로우와 CI/CD 환경을 위해 대화형 UI 없이 실행 가능한 헤드리스 모드를 지원한다. `oh run` 명령어와 `--json` 플래그를 조합하여 특정 프롬프트에 대한 결과를 구조화된 데이터로 받을 수 있다. 이는 테스트 실패 자동 수정이나 코드베이스 설명 생성과 같은 반복적인 작업을 파이프라인에 통합하는 데 유용하다.

bash

oh run "fix the tests" --json # CI/CD를 위한 헤드리스 모드 실행

대화형 UI 없이 특정 작업을 수행하고 결과를 JSON으로 출력하는 방법

용어 해설

코딩 에이전트(Coding Agent): — 사용자의 자연어 지시를 이해하여 코드를 읽고, 작성하고, 수정하며 셸 명령어를 실행하는 자율 AI 도구이다. 단순한 코드 완성을 넘어 문제 해결을 위한 계획 수립과 실행 과정을 스스로 수행한다.
헤드리스 모드(Headless Mode): — 사용자 인터페이스(UI) 없이 백그라운드에서 명령줄 인터페이스(CLI)를 통해 직접 실행되는 방식이다. 주로 CI/CD 파이프라인과 같은 자동화 환경에서 스크립트 형태로 AI 기능을 호출할 때 사용된다.
사용자 키 지참 방식(BYOK): — Bring Your Own Key의 약자로, 서비스 제공자가 API 비용을 청구하는 대신 사용자가 직접 자신의 API 키를 입력하여 사용한 만큼 비용을 지불하는 모델이다. 비용 최적화와 모델 선택의 자율성을 제공한다.
Git 통합(Git Integration): — 버전 관리 시스템인 Git과 도구를 연동하여 코드 변경 사항을 자동으로 기록하고 관리하는 기능이다. AI가 수정한 내용을 별도의 커밋으로 남겨 변경 이력을 추적하거나 이전 상태로 쉽게 되돌릴 수 있게 한다.

기술

TypeScript
Node.js
Ollama
OpenAI API
Anthropic API
React
Ink
Zod

활용 사례

터미널 기반 자율 코딩 보조
로컬 LLM을 활용한 무료 AI 프로그래밍
CI/CD 파이프라인 내 자동 코드 수정
기존 프로젝트의 대규모 리팩터링 및 테스트 자동화

언급된 리소스

GitHubOpenHarness GitHub Repository

API DocsOpenHarness npm Package

섹션별 상세

bash

npm install -g @zhijiewang/openharness
oh

OpenHarness를 전역 설치하고 실행하여 로컬 Ollama 모델을 자동 감지하는 과정

bash

oh --model ollama/qwen2.5:7b # 특정 로컬 모델 실행
oh --model gpt-4o # 클라우드 모델 실행 (API 키 필요)

로컬 모델과 클라우드 모델을 선택하여 실행하는 명령어 예시

근거

OpenHarness는 Ollama를 통한 로컬 모델과 OpenAI, Anthropic 등 다양한 클라우드 API를 모두 지원한다. — Providers 섹션 및 Why OpenHarness? 비교표

근거

AI의 모든 파일 변경 사항은 자동으로 Git에 커밋되며 /undo 명령어로 되돌릴 수 있다. — Git Integration 섹션

근거

Bash 실행, 파일 편집, 웹 검색 등 총 17개의 도구를 제공한다. — Tools (17) 목록 표

bash

oh run "fix the tests" --json # CI/CD를 위한 헤드리스 모드 실행

대화형 UI 없이 특정 작업을 수행하고 결과를 JSON으로 출력하는 방법

용어 해설

코딩 에이전트(Coding Agent): — 사용자의 자연어 지시를 이해하여 코드를 읽고, 작성하고, 수정하며 셸 명령어를 실행하는 자율 AI 도구이다. 단순한 코드 완성을 넘어 문제 해결을 위한 계획 수립과 실행 과정을 스스로 수행한다.
헤드리스 모드(Headless Mode): — 사용자 인터페이스(UI) 없이 백그라운드에서 명령줄 인터페이스(CLI)를 통해 직접 실행되는 방식이다. 주로 CI/CD 파이프라인과 같은 자동화 환경에서 스크립트 형태로 AI 기능을 호출할 때 사용된다.
사용자 키 지참 방식(BYOK): — Bring Your Own Key의 약자로, 서비스 제공자가 API 비용을 청구하는 대신 사용자가 직접 자신의 API 키를 입력하여 사용한 만큼 비용을 지불하는 모델이다. 비용 최적화와 모델 선택의 자율성을 제공한다.
Git 통합(Git Integration): — 버전 관리 시스템인 Git과 도구를 연동하여 코드 변경 사항을 자동으로 기록하고 관리하는 기능이다. AI가 수정한 내용을 별도의 커밋으로 남겨 변경 이력을 추적하거나 이전 상태로 쉽게 되돌릴 수 있게 한다.

기술

TypeScript
Node.js
Ollama
OpenAI API
Anthropic API
React
Ink
Zod

활용 사례

터미널 기반 자율 코딩 보조
로컬 LLM을 활용한 무료 AI 프로그래밍
CI/CD 파이프라인 내 자동 코드 수정
기존 프로젝트의 대규모 리팩터링 및 테스트 자동화

언급된 리소스

GitHubOpenHarness GitHub Repository

API DocsOpenHarness npm Package

OpenHarness: 로컬 및 클라우드 LLM을 지원하는 터미널 기반 오픈소스 AI 코딩 에이전트

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

OpenHarness: 로컬 및 클라우드 LLM을 지원하는 터미널 기반 오픈소스 AI 코딩 에이전트

섹션별 상세

용어 해설

기술

활용 사례

언급된 리소스

관련 토론

댓글

관련 피드

관련 토론

댓글

관련 피드