bigbud

모두를 위한 AI 작업 공간입니다. 연구, 글쓰기, 코딩, 파일 및 git 워크플로우를 한 곳에 보관하여 집중력을 유지하고 컨텍스트 스위칭을 줄여 더 많은 작업을 할 수 있게 합니다.

이름에 대하여: 이 프로젝트는 원래 bigCode(https://github.com/youpele52/bigCode)로 알려져 있었습니다. bigbud로의 리브랜딩은 우리의 진화된 비전을 반영합니다. 우리는 코딩 작업에 탁월하지만, 이제는 누구나 목표를 달성할 수 있도록 확장하고 있습니다. 좋은 친구처럼, bigbud는 프로그래머와 비프로그래머 모두에게 유용하기 위해 여기에 있습니다.

참고: 원래의 bigCode 저장소는 해킹되었거나 DMCA 처리되었습니다. 페이지가 404를 반환하더라도, Actions 및 Settings 페이지는 여전히 접근 가능합니다.

기능 (Features)

다중 공급자 지원 (Multi-provider support) — Codex, Claude, Copilot, OpenCode, Pi, Cursor 등 다양한 모델 간 전환이 가능합니다.
SSH를 통한 원격 프로젝트 작업 (Remote projects over SSH) — 전체 AI 런타임을 원격 장치로 옮기지 않고도 원격 폴더에서 작업할 수 있습니다.
데스크톱 및 웹 지원 (Desktop & Web) — 네이티브 Electron 데스크톱 앱 또는 경량 웹 UI를 제공합니다.
임베디드 브라우저 (Embedded browser) — 인앱(in-app)에서 링크를 열고, 브라우저 기록을 유지하며, 주석 처리된 페이지 컨텍스트를 채팅에 첨부할 수 있습니다.
실시간 스트리밍 (Real-time streaming) — 파일 변경 사항, 터미널 명령어, 셸 로그 및 추론 업데이트와 함께 실시간 출력을 제공합니다.
실시간 음성 인식 (Live speech-to-text) — OpenAI 기반의 실시간 전사(transcription) 기능을 통해 에이전트에게 말로 지시할 수 있습니다.
내장 터미널 및 채팅 셸 모드 (Built-in terminal and chat shell mode) — 통합된 터미널을 사용하거나 !ls와 같은 간단한 컴포저 명령어를 실행할 수 있습니다.
답글, 고정, 스레드 정리 (Replies, pinning, and thread organization) — 모든 메시지에 답장하고, 중요한 채팅을 고정하며, 재연결 시에도 컨텍스트를 유지할 수 있습니다.
승인 및 전체 액세스 모드 (Approvals and full access mode) — 향상된 스레드 컨텍스트로 승인 요청을 검토하거나, 자율 실행(autonomous runs)을 위해 명령어와 편집 사항을 자동 승인할 수 있습니다.
시스템 제어 (System control) — 에이전트에게 PC/Mac에서 명령을 실행하고 작업을 수행하도록 지시할 수 있습니다.
컴퓨터 사용 (데스크톱 및 브라우저 자동화) (Computer Use (Desktop & Browser Automation)) — 에이전트가 인앱 브라우저와, 데스크톱 환경에서는 macOS 장치를 제어할 수 있습니다. 탐색, 클릭, 타이핑, 스크롤, 스크린샷 캡처, 앱 실행, 창 목록 보기 등이 가능하며, 안전 가드레일(safety guardrails)을 통해 권한이 관리됩니다.
인라인 비디오 미리보기 (Inline video preview) — 파일 패널에서 비디오 파일(.mp4, .webm, .mov, .avi)을 네이티브 컨트롤과 HTTP Range 스트리밍으로 직접 재생할 수 있습니다.
우측 패널 탭 관리 (Right panel tab management) — 활성화된 우측 패널 탭(브라우저, diff, 파일, git, kanban, 노트, 터미널)을 Cmd+W / Ctrl+W로 닫을 수 있습니다.
스레드 포킹 (Thread forking) — 어느 지점에서든 대화를 분기하여 다른 가능성을 탐색할 수 있습니다.

빠른 설치 (Quick Install)

데스크톱 앱 (Desktop App)

최신 버전을 사용 중인 플랫폼에서 **bigbud.app/download**를 통해 다운로드하세요.

또는 터미널을 통해 설치할 수도 있습니다:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/youpele52/bigbud/main/apps/marketing/public/install.sh | sh

Windows:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/youpele52/bigbud/main/apps/marketing/public/install.ps1 | iex"

소스에서 가져오기 (From Source)

git clone https://github.com/youpele52/bigbud.git
cd bigbud
bun install
...

브라우저에서 http://localhost:5733을 열어주세요.

데스크톱 개발의 경우:

bun dev:desktop

프로바이더 설정 (Provider Setup)

bigbud은 여러 AI 코딩 에이전트를 지원합니다. **설정(Settings) → 프로바이더(Providers)**에서 최소 하나를 구성하세요:

프로바이더	설정 방법
Claude	Claude Code 설치: `npm i -g @anthropic-ai/claude-code`, 이후 `claude auth login` 실행
...
Provider 상태는 실시간으로 확인되며 설정에 표시됩니다. 각 프로바이더는 독립적으로 켜거나 끌 수 있습니다.

Claude의 SDK 통합, 인증 경계 및 복구 동작에 대한 자세한 내용은 bigbud에서 Claude를 참조하세요.

원격 프로젝트 (Remote Projects)

bigbud은 앱 경험을 로컬로 유지하면서 SSH를 통해 원격 프로젝트에 연결할 수 있습니다.

원격 작업 공간 지원 (Remote workspace support) — Codex, Claude, Copilot, OpenCode, Pi 등에서 지원되는 곳이라면 어디서든 원격 프로젝트를 열고 작업할 수 있습니다.
기본 에이전트 기반 (Agent-backed by default) — 지원되는 원격 작업 공간 작업은 제공자 셸(provider shell) 및 파일 브릿지(file bridges)를 포함하여 $HOME/.bigbud/agent/bin/current에 있는 관리형 Rust 에이전트를 사용합니다.
안전한 재연결 (Safer reconnects) — 재시작 후, 저장된 원격 작업 공간은 SSH 접근이 다시 확인될 때까지 연결되지 않은 상태로 유지됩니다.
유연한 잠금 해제 흐름 (Flexible unlock flow) — 비밀 정보를 저장하지 않고 SSH 키 또는 임시 암호 기반의 SSH 잠금 해제를 통해 재연결할 수 있습니다.
동의 게이트 설정 (Consent-gated setup) — 첫 사용 시, bigbud은 원격 에이전트 설치를 설명하고 원격 호스트에 무언가를 쓰거나 프로젝트를 생성하기 전에 명시적인 '예(Yes)' 응답을 기다립니다.
프로젝트별 연결 선택 (Per-project connection choice) — 원격 프로젝트를 추가하거나 편집할 때, bigbud 원격 에이전트 또는 직접 SSH(Direct SSH) 중 하나를 선택합니다. 이 선택은 저장되기 전에 확인되며, 두 가지 방법 모두 나란히 사용될 수 있습니다.
직접 SSH 옵션 (Direct SSH option) — 직접 SSH는 bigbud 에이전트 설치가 필요하지 않습니다. 원격 에이전트는 내구성이 필요한 원격 터미널, 장시간 실행되는 작업 및 복원력 있는 재연결을 위한 옵션입니다.

패키징된 데스크톱 빌드와 bun dev:desktop은 기본적으로 관리형 에이전트 전송(managed agent transport)을 사용하므로, 로컬 개발은 프로덕션 경로를 실행합니다. 새로운 원격 프로젝트는 선택한 방법을 유지하며, BIGBUD_REMOTE_AGENT_TRANSPORT는 레거시 대상 ID의 프로세스 기본값으로 계속 사용할 수 있고, BIGBUD_REMOTE_AGENT_BINARY는 사용자 지정 원격 경로 테스트를 위해 계속 사용할 수 있습니다. 패키징된 빌드는 같은 릴리스와 함께 게시되는 서명된 remote-agent-install-source.json을 사용합니다.

로컬 및 관리형 원격 파일 감시 기능은 Rust의 bigbud-workspace-watch 구현을 공유합니다. 서버 기반 개발 명령어는 네이티브 bigbud-remote-agent를 자동으로 구축하며, 패키징된 데스크톱 빌드에는 이 에이전트가 포함됩니다. 독립형 서버 배포 시에는 BIGBUD_LOCAL_WORKSPACE_AGENT_BINARY 환경 변수를 cargo build --locked --package bigbud-remote-agent로 빌드한 실행 파일로 설정할 수 있습니다. 누락되거나 호환되지 않는 바이너리는 다른 로컬 감시기로 폴백(fallback)하는 대신, 타입이 지정된 워처 진단으로 보고됩니다.

데스크톱 이벤트 전송 (Desktop Event Delivery)

패키징된 데스크톱 세션은 권위 있는 오케스트레이션 전송 코디네이터로 bigbud-desktop-supervisor를 포함합니다. TypeScript 서버는 여전히 이벤트와 SQLite 상태의 진실 공급원(source of truth)이며, Rust가 제한된 전송 순서, 소비자 세대(consumer generations), 애플리케이션 ACK, 타임아웃 복구 및 재연결 부착을 담당합니다. Electron은 실행 파일만 패키징하고 해결하며, 프로토콜은 프레임화된 stdio를 통해 서버와 사이드카 간에 직접 전송됩니다.

개발 환경에서는 bun run smoke:desktop-supervisor와 BIGBUD_DESKTOP_SUPERVISOR_ENABLED=1을 사용하여 이 경로를 테스트할 수 있습니다. BIGBUD_DESKTOP_SUPERVISOR_ENABLED=0은 시작 롤백(rollback) 경로를 선택합니다. 네이티브 복구가 모두 소진된 후, UI는 세션이 다시 연결될 때까지 활성 상태로 유지되는 격리된 TypeScript 폴백을 보고하며, 두 전송 경로는 절대 동시에 실행되지 않습니다.

컴퓨터 사용 (Computer Use)

bigbud의 컴퓨터 사용 기능은 AI 에이전트가 인앱 브라우저와 데스크톱 환경에서는 macOS 머신을 제어할 수 있게 합니다. 이를 통해 에이전트는 세션 내에서 웹 페이지 탐색, 양식 작성, 스크린샷 캡처, 애플리케이션 실행 등을 수행할 수 있습니다.

데스크톱 자동화 (Desktop Automation)

데스크톱 컴퓨터 사용은 오픈 소스 cua-driver MCP 백엔드를 통해 작동하며 macOS 접근성 및 화면 녹화 권한이 필요합니다.

권한 게이팅(Permission-gated) — 설정 → AI → 컴퓨터 사용에서 활성화하세요. 변경하는 동작(클릭, 타이핑, 키 누름)은 full-access 런타임 모드를 필요로 하며, 읽기 전용 동작(캡처, 창 목록 보기, 진단)은 모든 모드에서 작동합니다.
안전 가드레일(Safety guardrails) — 위험한 키 조합(Cmd+Q, Alt+F4)과 민감한 텍스트(비밀번호, API 키, 신용카드 번호)는 드라이버에 도달하기 전에 차단됩니다.
첫 실행 설정(First-run setup) — 데스크톱에서 설정 대화 상자가 기능을 활성화하고, cua-driver 런타임을 설치하며, macOS 권한을 부여하는 과정을 안내합니다.

브라우저 자동화 (Browser Automation)

브라우저 동작(탐색, 클릭, 타이핑, 스크롤, 스크린샷 캡처)은 내장된 Playwright 기반의 BrowserManager를 통해 작동합니다. 브라우저 자동화는 권한 옵트인(permission opt-in)을 요구하지 않으며 데스크톱 및 웹 모드 모두에서 작동합니다.

크로스 프로바이더 지원 (Cross-Provider Support)

컴퓨터 사용 기능은 모든 지원되는 제공업체(Codex, Claude, Copilot, OpenCode, Pi)에 개별 제공업체 브릿지—MCP stdio 서버, Copilot SDK 도구, Pi 코딩 에이전트 확장 프로그램—를 통해 주입되며, 이는 세션 시작 시 자동으로 설정됩니다.

음성-텍스트 변환 (Speech to Text)

OpenAI의 Realtime Transcription API 기반 음성 받아쓰기 기능입니다. 설정 → 음성-텍스트 변환에서 API 키를 추가하여 활성화할 수 있습니다.

사용자 지정 키 사용 (Bring Your Own Key)

이 기능은 사용자의 OpenAI API 키를 사용합니다—음성 입력을 사용하려면 구성된 키가 있어야 합니다. 이를 통해 비용을 분리하고 bigbud가 사용자의 OpenAI 계정에 접근할 필요성을 없앱니다.

작동 방식 (How It Works)

오디오 캡처: Web Audio API와 AudioWorkletNode를 사용하여 마이크 입력을 24 kHz의 PCM16으로 캡처합니다.
스트리밍: 오디오는 브라우저에서 OpenAI로 WebSocket을 통해 직접 스트리밍됩니다—bigbud 서버에 절대 도달하지 않습니다.
턴 감지 (Turn detection): 수동 제어—녹음하려면 누르고, 보내려면 놓습니다. 말하는 동안 실시간으로 부분 받아쓰기가 나타납니다.
모델: gpt-realtime-whisper를 사용하는 OpenAI의 실시간 받아쓰기 세션 흐름을 사용합니다.

사용법 (Usage)

**설정(Settings) → AI → 음성 인식(Speech to Text)**으로 이동합니다.
OpenAI API 키(접두사 sk-로 시작)를 입력합니다.
**저장 및 확인(Save & Verify)**을 클릭하여 키를 검증합니다.
작곡기(composer)에서 마이크 버튼을 클릭하고 말합니다.

macOS: 음성 입력을 처음 사용하는 경우, macOS가 마이크 접근 권한 부여를 요청할 것입니다. 이전에 거부했다면, 시스템 설정(System Settings) → 개인 정보 보호 및 보안(Privacy & Security) → 마이크로 이동하여 해당 앱에 대한 권한을 다시 활성화해야 합니다.

데스크톱 대 웹 (Desktop vs Web)

	데스크톱 (Desktop)	웹 (Web)
설치(Installation)	네이티브 설치 프로그램 (Native installer)	`bun dev` 또는 자체 호스팅 (self-hosted)
...

문서 (Documentation)

AGENTS.md — 개발 가이드 (Development guide)
docs/CHANGELOG.md — 최근 프로젝트 변경 사항 및 그룹화된 릴리스 기록
CONTRIBUTING.md — 기여 지침 (Contribution guidelines)
docs/release.md — 릴리스 워크플로우 및 서명(Release workflow & signing)
docs/observability.md — 관측 가능성 설정 (Observability setup)

개발 (Development)

# 전체 개발 스택 (서버 + 웹)
bun dev

...

데스크톱 패키징 (Desktop Packaging)

bun dist:desktop:dmg:arm64   # macOS Apple Silicon
bun dist:desktop:dmg:x64     # macOS Intel
bun dist:desktop:linux       # Linux AppImage
...

상태 (Status)

bigbud는 활발하게 사용되고 유지보수되고 있습니다. 최신 업데이트는 changelog를 참조하세요.

현재 기여(contribution)는 받지 않습니다. 자세한 내용은 CONTRIBUTING.md를 참고하십시오.

bigbud: 모두를 위한 AI 작업 공간

요약

핵심 포인트