OpenSource03/harnss

경고

Harnss는 초기 개발 단계에 있으며 이슈가 발생할 수 있습니다. Issues 섹션에 버그 및 이슈를 자유롭게 보고해 주세요.

당신의 AI 코딩 에이전트(AI coding agents)를 활용하세요.

Harnss는 컨텍스트(context), 세션(sessions), 또는 도구 상태(tool state)를 잃지 않고 Claude Code, Codex, 그리고 모든 ACP 호환 에이전트(ACP-compatible agent)를 실행, 관리 및 전환할 수 있는 단일 인터페이스를 제공하는 크로스 플랫폼 데스크톱 앱입니다.

왜 Harnss인가요?

하나의 앱, 모든 에이전트. Claude Code, Codex, 그리고 커스텀 ACP 에이전트를 나란히 실행하세요. 더 이상 터미널을 번갈아 사용하거나 도구를 전환할 때 컨텍스트를 잃을 필요가 없습니다.
당신의 AI가 실제로 무엇을 하고 있는지 확인하세요. 도구 호출(Tool calls)은 가공되지 않은 JSON이 아니라, 단어 단위의 차이(word-level diffs), 구문 강조(syntax highlighting), 인라인 Bash 출력(inline bash output)이 포함된 대화형 카드 형태로 렌더링됩니다.
당신의 워크스페이스, 당신의 방식대로. 내장된 터미널, 브라우저, git, MCP 서버 및 파일 패널 — 이 모든 것이 프로젝트별로 범위가 지정되며, 작업하는 동안 계속 열려 있습니다.

터미널, 브라우저, git, 그리고 MCP 통합 — 이 모든 것이 하나의 창에 있습니다.

하나의 UI - 모든 에이전트. 전체 ACP 레지스트리(registry)를 탐색하세요.

클릭하여 다른 스크린샷 보기

spaces.mp4

프로젝트를 스페이스(spaces)로 정리하세요.

모든 도구 호출이 아름답게 시각화됩니다 - 인기 있는 MCP의 호출까지도.

여러 에이전트 세션을 나란히 실행하세요 — 진행 상황을 잃지 않고 즉시 전환할 수 있습니다.

Claude Code (Anthropic SDK를 통해), Codex, 그리고 ACP 호환 에이전트를 병렬로 실행하세요. 각 세션은 고유한 상태(state), 히스토리(history), 그리고 컨텍스트(context)를 가집니다. 이들 사이를 즉시 전환할 수 있습니다.

모든 도구 호출은 대화형 카드로 렌더링됩니다. 파일 편집은 구문 강조가 포함된 단어 단위의 차이(word-level diffs)를 보여줍니다. Bash 출력은 인라인으로 나타납니다. 하위 에이전트(Subagent) 작업은 단계별 진행 추적과 함께 중첩됩니다. 파일 변경 사항은 전용 변경 사항(Changes) 패널을 통해 턴(turn)별로 요약됩니다.

stdio, SSE 또는 HTTP 전송 방식을 통해 프로젝트별로 모든 MCP 서버를 연결하세요. OAuth 흐름은 자동으로 처리됩니다. 서버 상태와 사용 가능한 도구 수를 한눈에 확인할 수 있습니다. Jira, Confluence 및 기타 통합 기능은 가공되지 않은 JSON 대신 전용 UI로 렌더링됩니다.

앱을 벗어나지 않고도 스테이지 (Stage), 언스테이지 (unstage), 커밋 (commit), 푸시 (push)를 수행할 수 있습니다. 브랜치 (branches)를 탐색하고, 커밋 히스토리 (commit history)를 확인하며, git 워크트리 (worktrees)를 관리하세요. 스테이지된 디프 (staged diff)를 기반으로 AI가 생성한 커밋 메시지를 사용할 수 있습니다.

네이티브 셸 (shell) 프로세스를 기반으로 하는 멀티 탭 PTY 터미널을 제공합니다. URL을 인라인으로 열고 에이전트 (agent)에게 추가적인 컨텍스트 (context)를 제공하기 위한 임베디드 브라우저 (embedded browser)가 포함되어 있습니다. 작업하는 동안 두 패널 모두 마운트된 상태를 유지합니다.

프로젝트 (Projects)는 디스크의 폴더와 매핑됩니다. 스페이스 (Spaces)를 사용하면 프로젝트를 사용자 정의 아이콘 및 색상이 지정된 이름 그룹으로 구성할 수 있습니다. 세션 (Sessions), 히스토리 (history), 패널 설정은 모두 프로젝트별로 범위가 지정됩니다.

앱에서 직접 ACP 커뮤니티 레지스트리 (community registry)로부터 에이전트를 찾아 설치할 수 있습니다. 명령 (command), 인자 (arguments), 환경 변수 (environment variables), 아이콘을 지정하여 커스텀 에이전트를 추가하세요. 모든 설정은 설정 (Settings) 메뉴를 통해 관리되며, 별도의 설정 파일 (config files)은 필요하지 않습니다.

플랜 모드 (plan mode)에서 작업하면 에이전트가 변경 사항을 적용하기 전에 계획을 초안으로 작성합니다. 세 가지 권한 수준 — 먼저 묻기 (Ask First), 편집 수락 (Accept Edits), 모두 허용 (Allow All) — 을 통해 에이전트의 자율성을 제어할 수 있습니다. 컨텍스트를 방해하지 않고 언제든지 모드를 전환할 수 있습니다.

세션 중에 생성된 태스크 에이전트 (Task agents)는 백그라운드에서 계속 실행되며 전용 패널에서 추적됩니다. 시간이 오래 걸리는 작업이 완료되는 동안 다른 세션에서 계속 작업할 수 있습니다.

채팅에 스크린샷이나 이미지를 직접 첨부하세요. 내장된 어노테이션 (annotation) 도구를 사용하면 이미지를 에이전트에게 보내기 전에 자유로운 필기(freehand strokes)로 그림을 그리거나, 강조하거나, 표시할 수 있습니다.

네이티브 macOS 받아쓰기 또는 온디바이스 (on-device) Whisper 모델을 통한 음성 입력을 지원합니다 (API 키가 필요하지 않음). 플랜 승인 요청, 권한 프롬프트, 에이전트 질문 및 세션 완료에 대해 구성 가능한 OS 알림을 제공합니다.

세션 제목과 메시지 내용 전체에 대한 전체 텍스트 검색 (Full-text search)을 지원합니다. 이전에 Claude Code CLI에서 시작한 대화를 가져오고 재개할 수 있습니다.

다운로드: Releases 페이지에서 사용 중인 플랫폼의 최신 릴리스를 다운로드하세요. 프로젝트 열기: Harnss를 디스크의 특정 폴더로 지정하세요. 엔진 선택: Claude Code, Codex 또는 설치된 모든 ACP 에이전트를 선택하여 작업을 시작하세요.

Harnss는 기본적으로 세 가지 실행 엔진 (execution engines)을 지원합니다:

엔진 (Engine)	프로토콜 (Protocol)	요구 사항 (Requirements)
Claude Code	Anthropic Agent SDK	Claude 계정 (구독 또는 API 키)
Codex	JSON-RPC app-server	PATH에 Codex CLI 포함 + OpenAI API 키 또는 ChatGPT 계정
ACP 에이전트 (ACP agents)	Agent Client Protocol	에이전트별 상이 (레지스트리 참조)

Claude Code와 Codex는 내장되어 있습니다. ACP 에이전트는 앱 내부의 ACP 에이전트 레지스트리 (ACP Agent Registry)에서 설치하거나 수동으로 구성할 수 있습니다.

설치 가능한 ACP 호환 에이전트 예시:

에이전트 (Agent)	명령 (Command)	참고 사항 (Notes)
Gemini CLI	gemini --experimental-acp	실험적 ACP 플래그 (Experimental ACP flag)
Goose	goose acp
Docker cagent	cagent acp agent.yml	컨테이너 기반 에이전트 (Container-based agents)

**설정(Settings) → ACP 에이전트(ACP Agents)**를 엽니다. 에이전트 스토어(Agent Store) 탭에서는 커뮤니티 레지스트리에서 에이전트를 찾아 설치할 수 있습니다. 내 에이전트(My Agents) 탭에서는 사용자 정의 에이전트를 생성할 수 있습니다. 바이너리 명령, 인자 (arguments), 환경 변수 (environment variables), 아이콘을 설정하거나 JSON 정의를 붙여넣어 양식을 자동으로 채울 수 있습니다.

MCP 서버는 우측 도구 모음의 MCP 서버(MCP Servers) 패널을 통해 프로젝트별로 구성됩니다. 지원되는 전송 방식 (transports): stdio, SSE, HTTP입니다. OAuth 인증은 앱 내에서 처리되며 세션 간 토큰 지속성 (token persistence)이 유지됩니다.

참고

사전 빌드된 바이너리는 현재 서명되지 않았습니다 (unsigned). macOS에서는 앱을 우클릭하고 **열기(Open)**를 선택하여 첫 실행 시 Gatekeeper 경고를 우회하세요. Windows에서 Windows Defender가 설치 프로그램을 차단하는 경우 **추가 정보(More info) → 실행(Run anyway)**을 클릭하세요.

플랫폼 (Platform)	다운로드 (Download)
macOS (Apple Silicon)	.dmg (arm64)
...

git clone https://github.com/OpenSource03/harnss.git
cd harnss
pnpm install
...

pnpm dist:mac # macOS DMG (arm64 + x64)
pnpm dist:win # Windows NSIS installer (x64 + ARM64)
pnpm dist:linux # Linux AppImage + deb

• 저장소 (repo)를 포크(Fork)하고 기능 브랜치 (feature branch)를 생성하세요.
• CLAUDE.md에 명시된 컨벤션을 따르세요.
• pnpm dev로 테스트하세요.
• 풀 리퀘스트 (pull request)를 생성하세요.

MIT

Agent Client Protocol을 기반으로 구축되었습니다.