blueberrycongee/wuu

AI 에이전트가 로컬 프로젝트에서 작업하는 오픈 소스 데스크톱 앱으로,
에이전트가 읽는 모든 파일, 실행하는 명령어, 변경하는 모든 줄이 화면에 표시됩니다.

Mac용 다운로드 ·
문서화 ·
简体中文

wuu를 폴더에 지정하고 작업을 설명하면, 에이전트가 코드를 읽고, 명령어를 실행하며, 파일을 편집합니다. 대화 내용은 각 단계별로 표시됩니다. 그 옆의 Review에서는 디스크상의 실제 diff(차이점)를 보여주므로, 요약 내용을 맹신하기보다 결과를 직접 확인할 수 있습니다.

사용자가 10월 1일 지출이 9월에 기록된다고 보고합니다. 에이전트는 코드를 검색하고, 테스트를 실행하여 버그를 재현하며, 월 계산을 수정하고 테스트 케이스를 추가합니다. 한 번의 클릭으로 Review에서 변경 사항을 열어볼 수 있습니다.

OpenAI, Anthropic, DeepSeek, xAI, Kimi, Z.AI, MiniMax 또는 Alibaba Cloud Model Studio와 API 키로 연결할 수 있습니다. OpenRouter나 SiliconFlow 같은 게이트웨이 및 LM Studio 같은 로컬 서버도 작동하며, 모든 사용자 지정 OpenAI 또는 Anthropic 호환 엔드포인트도 가능합니다. 또한 이미 가지고 있는 구독(Codex 로그인, xAI SuperGrok 또는 Grok Build)을 재사용할 수도 있습니다.

이미 다른 코딩 에이전트를 사용하고 있나요? wuu는 해당 에이전트의 자체 로그인 및 도구를 사용하여 Claude Code, Codex, Cursor, Devin, Grok, Hermes, OpenCode, Pi 또는 Antigravity를 대화 엔진으로 실행할 수 있습니다. **설정 → 구독(Settings → Subscriptions)**에서는 모든 계정의 플랜 할당량과 잔액을 한 곳에서 확인할 수 있습니다.

작업 공간 패널은 대화 옆에 위치합니다:

Review는 현재 Git diff를 파일별로 보여줍니다.Files는 코드, Markdown, 이미지 및 문서를 미리보기 합니다.Terminal은 프로젝트 내 셸을 열어줍니다.Browser는 에이전트가 조작하는 것과 동일한 페이지입니다. 떠다니는 미리보기가 에이전트의 클릭을 따라가며, 사용자가 직접 페이지를 클릭하거나 입력하면 작업이 일시 중지됩니다.

파일에서 텍스트를 선택하여 대화에 추가하거나, 댓글을 남기거나, 사이드 채팅으로 질문하거나, 에이전트에게 해당 구절만 편집하도록 요청할 수 있습니다. 응답도 같은 방식으로 작동합니다: 다음 메시지에 특정 구절을 인용(quote)할 수 있습니다.

작업이 실행되는 동안 Enter 키를 누르면 방향을 조정할 수 있고, Command + Enter를 누르면 다음 메시지를 대기열에 추가할 수 있습니다. 이전 메시지에서 같은 폴더나 새로운 Git worktree로 포크(fork)할 수 있습니다. 실험 내용이 현재 브랜치에 영향을 주지 않도록 별도의 worktree에서 대화를 시작하세요. /side를 사용하면 메인 스레드와 분리된 빠른 질문을 할 수 있고, 검색 기능을 사용하여 과거의 모든 대화를 찾을 수 있습니다.

각 대화에 대한 권한 모드를 선택해야 합니다. **읽기 전용(Read-only)**은 조사 목적으로 사용됩니다. **표준(Standard)**은 작업 공간 내에서 편집을 허용합니다. **제한 없음(Unconfined)**은 정말 필요할 때 경계를 해제합니다. 읽기 전용 및 표준 모드에서는 에이전트의 명령이 macOS Seatbelt 샌드박스 내부에서 실행됩니다. 모델이 셸 명령어와 위험한 작업을 실행하기 전에 검토하도록 하려면 **나를 위해 승인(Approve for me)**을 켜세요.

작업이 다른 곳에 속하는 경우, 에이전트의 도구를 Docker, SSH, Singularity/Apptainer 또는 Modal, Daytona 또는 Vercel 샌드박스에서 실행하세요.

플러그인(Plugins)은 예약 자동화, 영구 목표 설정, 작업 체크리스트, 메모리, 서브에이전트 등 도구와 기능을 추가합니다. 각 플러그인은 켜거나 끌 수 있습니다. 로컬 플러그인을 설치하고, 기술을 추가하며, MCP 서버를 연결하고, 후크(hooks)를 실행할 수 있습니다. 확장 기능(Extensions)은 번들된 플러그인과 동일한 공개 API를 사용합니다. wuu의 Extend 기능을 참조하세요.

데스크톱 미리보기는 Apple silicon Mac에서 실행됩니다. GitHub Releases에서 다운로드하여 wuu.app을 /Applications로 이동하고 열면 됩니다.

이 미리보기는 서명이 되어 있지 않습니다. Apple Developer ID나 노타라이제이션(notarization) 없이 애드혹 서명만 되어 있습니다. macOS가 이를 차단하는 경우, 설치 가이드를 따르세요.

최초 실행 시 모델 서비스를 연결하고 프로젝트 폴더를 작업 공간으로 추가하세요. 작은 작업부터 시작한 다음, 검토(Review)에서 변경 사항과 테스트 결과를 확인해 보세요. 빠른 시작 기능은 예시 과정을 안내합니다.

데스크톱 앱에는 자체 코어(core)가 포함되어 있습니다. 터미널이나 스크립트에서도 wuu를 사용하려면 go.mod에 나열된 Go 버전을 설치하고 CLI를 빌드하세요:

git clone https://github.com/blueberrycongee/wuu.git
cd wuu
make install
...

Go의 바이너리 디렉터리가 PATH에 포함되어 있는지 확인하세요.

, 그리고 모델 제공업체를 구성합니다. 그런 다음 작업을 실행합니다:

cd /path/to/your/project
wuu exec --permission-mode read_only "이 프로젝트를 검토하고 테스트를 실행하는 방법을 설명해 주세요"

wuu exec은 스크립팅, JSONL 출력 및 세션 제어에 대한 가이드가 포함되어 있습니다.

wuu는 로컬 파일을 읽고 변경하며 활성 권한 모드 내에서 명령을 실행합니다. 프롬프트와 관련 컨텍스트는 선택한 모델 제공업체로 전송됩니다. 세션과 설정은 기본적으로 ~/.wuu에 저장됩니다.
민감한 데이터나 신뢰할 수 없는 프로젝트를 다루기 전에 보안 모델을 읽어보세요.

wuu 개발에 기여하려면 Contributing을 참조하거나, 문제를 보고하려면 이슈를 여세요. 보안 취약점은 SECURITY.md를 통해 신고해 주세요.
Fusion의 멀티 에이전트 협업(Lead/Sidekick 협업 설계, 사용자 경험 및 행동 테스트 포함)에 기여한 @Rosemary1812에게 감사드립니다(#489).

MIT 라이선스 하에 배포됩니다. 에이전트 아바타는 MIT 라이선스가 적용된 blobatar를 사용합니다. 위의 스크린샷은 합성 예제 프로젝트에서 실제로 작동하는 앱의 결과이며, landing/README.md에서 이를 재생성하는 방법을 설명합니다.