risa-labs-inc/BossConsole

BossConsole – AI 에이전트를 위한 오픈소스 데스크톱 콘솔

무엇인가요 – Kotlin Multiplatform + Compose로 구축된 크로스플랫폼 데스크톱 애플리케이션 (macOS, Windows, Linux)으로, 대규모 언어 모델 에이전트에게 실제 워크스테이션을 제공합니다: 내장 브라우저, 공유 가능한 터미널, 코드 에디터, git 통합, 시크릿 관리, 플러그인 "Toolbox". 앱 자체도 Model Context Protocol (MCP) 를 통해 에이전트에 노출되어, 에이전트가 약 100개의 도구 (예: browser_navigate, git_status, docker_ps)를 호출하고, 실행 중인 UI를 조작할 수 있습니다.

왜 중요한가요 – 대부분의 AI 에이전트용 데스크톱 도구 (Claude Desktop, Cursor 등)는 폐쇄 소스, 단일 벤더, Electron의 싱글스레드 자바스크립트 런타임 기반입니다. BossConsole은 처음으로 오픈소스, JVM 네이티브, 진정한 멀티스레드 허브로서,

• 어떤 LLM 백엔드 (Claude Code, Codex, Gemini, OpenCode 등)와도 호환 가능 – 자신만의 에이전트를 가져오세요.
• 모델에 풍부하고 관리 가능한 도구 세트를 제공하여 단순한 채팅이 아닌 자율적이고 다단계 워크플로우를 가능하게 합니다.
• 에이전트가 내장 브라우저 (Fluck)를 제어, 터미널 명령어를 실행하고, 파일을 편집하며, Docker/Kubernetes를 관리할 수 있습니다 – 모두 동일한 프로세스 내에서.
• 도구별 RBAC, 각 도구의 킬스위치, 암호화된 사용자 범위 시크릿을 제공하여 운영자가 모델이 할 수 있는 행동을 세밀하게 제어할 수 있습니다.
• 런타임 중 플러그인의 핫리로드를 지원하여, 에이전트가 앱을 재시작하지 않고도 자신의 능력을 진화시킬 수 있습니다.

주요 구성 요소

구성 요소	기능
MCP 서버	루프백 HTTP + SSE (127.0.0.1:7677)로, 연결된 모든 LLM 클라이언트에 mcp__boss__* 도구를 공지합니다.
Toolbox (플러그인 스토어)	터미널, 에디터, Fluck 브라우저, Docker, K8s, Jupyter 등용 내장 마켓플레이스. 플러그인은 서명되어 있으며, 핫로드 가능하며 새로운 MCP 도구를 기여할 수 있습니다.
BossTerm	QR 코드 또는 암호화된 링크를 통해 스마트폰에서 접근 가능한 공유 터미널; 보기 전용 또는 전체 제어 모드를 지원합니다.
Fluck 브라우저	가벼운 내장 Chromium 기반 브라우저로, 에이전트가 스크립트 가능 (browser_navigate, browser_run_js)하며, 시크릿 매니저에서 자동으로 자격 증명을 채웁니다.
거버넌스 레이어	Supabase/Postgres에 저장된 서버 사이드 RBAC, 도구별 토글, 킬스위치, 서명된 플러그인 검증.
Tool Creator / Evolver	새로운 플러그인 (매니페스트, 빌드 파일, 스켈레톤 UI)을 스크래핑하는 워즈드로, 에이전트가 반복적으로 개선할 수 있으며, 핫리로드 및 PR 생성도 지원합니다.

설치 방법

• 사전 빌드된 설치 프로그램 – Homebrew Cask, MSI, DEB, RPM 또는 JAR는 컨패니언 BossConsole-Releases 리포지토리에서 이용 가능. 다운로드 URL은 최신 버전과 SHA-256 체크섬을 반환하는 latest-release 엣지 함수를 통해 제공됩니다.
• 빠른 설치 (macOS 예시):

  brew install --cask boss   # 또는 유니버설 스크립트
  curl -fsSL https://raw.githubusercontent.com/risa-labs-inc/BossConsole-Releases/main/install.sh | bash
  

• 앱은 JVM에서 실행되므로, 호환 가능한 Java 런타임이 있는 모든 플랫폼에서 제공된 JAR로 시작할 수 있습니다.

에이전트 실행 – 터미널 탭을 열고, LLM CLI (예: claude, codex, gemini, opencode)를 시작한 후, 다음과 같은 단일 명령어로 MCP 서버에 연결합니다:

claude mcp add --scope user --transport sse boss http://127.0.0.1:7677

에이전트는 즉시 전체 boss 도구 세트에 접근할 수 있으며, 워크스테이션 자동화를 시작할 수 있습니다.

거버넌스의 실천

• 권한은 PostgreSQL 행에 정의되며, MCP 서버에서 강제 적용됩니다. 플러그인은 필요로 하는 권한을 선언합니다.
• 관리자 사용자는 권한 검사를 우회하지만, 도구별 킬스위치 (비활성화된 도구의 JSON 목록)는 여전히 적용되어, 단일 사용자 데스크톱에서 신뢰할 수 있는 안전 장치를 제공합니다.
• 시크릿은 암호화되어 사용자별 범위로 제한되며, secret_get 도구가 명시적으로 호출되지 않는 한 모델로 전송되지 않습니다.
• 플러그인은 서명됨 (pluginId|version|sha256); 변조된 JAR는 로드되지 않습니다.

성능 참고 – 내장된 Fluck 브라우저는 Speedometer 3.1에서 47.9 점을 기록 (동일한 과부하 테스트 환경에서 Chrome보다 약 30% 빠름)하여, 네이티브 JVM UI가 주류 브라우저와 경쟁 가능함을 보여줍니다.

---

TL;DR

• BossConsole = AI 에이전트를 위한 오픈소스, 멀티플랫폼 데스크톱 환경.
• 어떤 LLM (Claude, Codex, Gemini, OpenCode)을 가져와도 실제 도구 (브라우저, 터미널, git, Docker, K8s, 시크릿)를 제공.
• RBAC, 도구별 킬스위치, 서명된 플러그인으로 거버넌스.
• 핫리로드 가능한 플러그인으로 에이전트가 런타임 중 자신의 능력을 진화 가능.
• Homebrew, MSI/DEB/RPM, 또는 제공된 JAR로 설치 가능.