juggler-ai/juggler

Juggler – AI 코딩 에이전트를 위한 비주얼 워크벤치

개요

코드 바로 옆에서 AI 코딩 에이전트를 실행할 수 있는 데스크톱(및 웹) 애플리케이션입니다. UI는 전체 대화를 트리로 표시하고, 각 모델 요청/응답을 검사하며, 도구 호출(예: read, write, bash)을 관리할 수 있습니다.
백엔드는 Go 서버(juggler)로, 로컬, 개발 상자, 원격 서버에서 실행할 수 있습니다. 동일한 세션을 네이티브 앱, 브라우저 또는 여러 클라이언트에서 동시에 열 수 있습니다.

중요성

투명성 – 모든 LLM 트랜잭션을 열어 정확한 시스템 프롬프트, 메시지, 도구 스키마, 토큰 사용량, 타이밍을 확인할 수 있습니다. 숨겨진 "채팅 창"이 없습니다.
컨텍스트 수술 – 대화는 탐색 가능한 트리입니다. 하위 스레드에서 분기하고, 항목을 이동하거나 복사하고, 변경을 실행 취소하여 메인 컨텍스트를 깨끗하게 유지할 수 있습니다.
벤더 중립 – Anthropic/Claude, OpenAI/Codex, GitHub Copilot, Gemini, Ollama, OpenRouter, Mistral, DeepSeek 등과 호환됩니다. API 키는 직접 제공합니다. Juggler는 트래픽을 프록시하지 않습니다.
확장 가능 – 확장 기능은 Apache-2.0 SDK를 사용하여 JavaScript로 작성됩니다. 앱 전체를 다시 빌드하지 않고 새 도구, 전략, 슬래시 명령, UI 카드 또는 MCP(Model-Control-Protocol) 통합을 추가할 수 있습니다.

사용 방법

다운로드 – macOS, Windows, Linux용 사전 빌드된 바이너리(또는 소스에서 빌드 – Go 1.26+, 하위 모듈). 패키지에는 다음이 포함됩니다:
- juggler – 세션을 호스팅하고 웹 UI를 제공하는 헤드리스 서버.
- Juggler.app / juggler-app – 네이티브 데스크톱 클라이언트.
서버 실행 (juggler). localhost URL과 QR 코드가 표시됩니다. b를 눌러 브라우저를 열고, w를 눌러 데스크톱 클라이언트를 시작하고, p/--public으로 LAN 액세스를 허용합니다.
연결 – 데스크톱 앱 또는 모든 브라우저에서 연결합니다. UI에는 트리, 도구 호출, 파일 뷰어용 밀러 컬럼 패인이 표시됩니다.
상호작용 – 코딩 에이전트와 상호작용: 프롬프트 전송, 에이전트가 도구 호출, 각 턴 검사, 하위 스레드 분기, 도구 실행 승인/거부, 나중에 재개 – 전체 세션은 디스크에 저장됩니다.

주요 기술 사항

백엔드: Go + Wails(네이티브 윈도우). Electron 없음. UI는 Go 프로세스가 제공하는 순수 HTML/JS입니다.
협업: 세션 문서는 Yjs로 저장되어 여러 클라이언트가 동일한 라이브 트리를 보고 편집할 수 있습니다.
확장 기능: JavaScript SDK. 번들된 확장 기능은 일반적인 도구(read, write, bash)를 제공합니다. CLI를 통해 새 확장 기능을 스캐폴드하고 핫 리로드할 수 있습니다.
MCP 지원: Juggler는 외부 Model-Control-Protocol 서버의 클라이언트 역할을 하여 모델에 전송된 정확한 스키마와 도구 결과를 표시할 수 있습니다.
라이선스: 핵심 앱은 AGPL-v3(호스팅 서비스는 소스 공개 필수). 확장 SDK 및 예제는 Apache-2.0으로, 클로즈드 소스 플러그인을 허용합니다.

대상

도움말

위 정보는 모두 저장소의 README에서 직접 가져왔습니다.