<div align="center">
<img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/desktop/icon.png" width="96" alt="">
dotpals
코딩 에이전트가 실제로 무엇을 했는지 확인하세요.
Claude Code, Codex 또는 모든 에이전트를 감시하고 그 작업을 확인하는 작은 플로팅 팔(pal)입니다. 어떤 파일이 변경되었는지, 어떤 명령어가 실행되었는지, 그리고 테스트가 정말 통과했는지 여부를 확인합니다. 이는 에이전트의 말에 의존하지 않고 출력 내용을 읽습니다. Claude가 테스트를 실패시키면, dotpals는 이를 수정하도록 다시 보냅니다. 모든 AI 도구는 dotpals에게 실제로 무슨 일이 일어났는지 물어볼 수 있습니다. 그리고 이제 대화할 수도 있습니다: Blu는 사용자의 화면을 보고, 설명하면서 그 위에 그림을 그리며, 사용자의 앱을 사용합니다.
<sub style="font-size: 0.9em;">Windows, macOS 또는 Linux에서 단 하나의 명령어로 설정할 수 있습니다. 무료이며 오픈 소스이며, 에이전트의 작업은 사용자의 컴퓨터에 남아있습니다. 또는 GitHub에서 바로 실행하세요: npx --allow-git=all github:rikinshah787/dotpals setup</sub>
CI
License: MIT
Works with Claude Code and Codex
설치 · Blu와 대화하기 · 기능 · 모든 에이전트 연결 · 문서
⭐ dotpals 별점 주기: 에이전트가 "완료!"라고 말했지만 확신하지 못했을 때 · 혼란스러운 점 알려주기
</div>
0.12 버전의 새로운 기능: Blu와 대화하기
<p align="center"><img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/docs/blu.gif" width="760" alt="사용자가 말합니다: Blu, 이 차트를 간단히 설명하고 가장 좋은 달에 동그라미를 쳐줘. Blu는 화면을 보고, 상단의 빈 공간(notch)에서 답변하며 (각 막대는 한 달이며 판매량은 연말에 걸쳐 주로 상승함), 최고의 달인 11월 주위에 빨간색 원을 그립니다."></p>
Ctrl+Shift+Space를 누르고 말하세요. Blu는 사용자의 빈 공간(notch)에 있는 팔입니다:
- 화면을 설명합니다. "이 오류는 무엇인가요?"라고 물으면 Blu가 소리 내어 답하고 의미를 원으로 표시해 줍니다. 단계별로 질문하면 화면에서 작업하는 내용을 줄 단위로 작성합니다.
- 작업을 수행합니다. "재즈 음악 좀 틀어줘", "볼륨을 조금 낮춰줘", "이 창을 더 작게 만들어줘" 등 각 요청마다 ✓ 또는 ✗ 표시를 보여줍니다.
- 사용자의 앱을 활용합니다. Notion, Linear, Sentry, Google Calendar 또는 모든 MCP 서버가 가능합니다. 변경 사항은 사용자의 승인을 기다리며, 어떠한 내용도 전송되거나 삭제되거나 결제되지 않습니다.
- 코딩 작업을 Claude에게 맡기고 검증합니다. "Claude에게 실패한 테스트를 수정하게 해줘"라고 하면 Blu는 무엇이 완료되었는지 작성하고, Claude Code가 이를 수행하며, dotpals가 실제로 어떤 일이 일어났는지 확인합니다.
- 사용자가 이미 가진 AI 위에서 작동합니다. 구독 기반의 Claude Code 또는 Codex, API 키, 혹은 Ollama 등 사용자의 컴퓨터에서 청취 및 Blu의 음성으로 구동됩니다.
더 자세한 내용은 Talk to Blu를 참고하세요. 0.11 버전에서는 리포트 카드(report card), 재생/되감기(replay and rewind), 아침 브리핑(morning brief), 그리고 "멈춤 상태" 기능이 추가되었으며, 모든 내용은 changelog에서 확인할 수 있습니다.
왜 필요한가요 (Why)
코딩 에이전트는 단일 요청만으로도 많은 작업을 수행합니다. 수십 개의 파일을 읽고, 몇 개를 수정하며, 테스트를 실행하고, 재시도하며, 검색까지 합니다. 채팅 기록은 스크롤되고 diff는 여러 파일에 걸쳐 퍼집니다. dotpals는 편집기 옆에 실시간의 평이한 언어(plain-language) 기록을 유지하여, 사용자가 항상 다음 질문에 답할 수 있게 해줍니다:
- 무엇을 변경했나요? 수정, 생성 또는 삭제된 모든 파일과 diff를 한 번의 클릭으로 확인할 수 있습니다.
- 무엇을 실행했고, 작동했나요? 출력 결과와 함께 모든 명령어를 확인하며, 2차 시도에서 수정됨(fixed on try 2) 또는 3회 시도 후에도 여전히 실패함(still failing after 3 tries) 등의 상태를 알 수 있습니다.
- 고장 난 것을 고쳤나요? 테스트가 실패하면 Claude Code가 다시 전송되며, 단순히 통과시키기 위해 변경된 테스트는 포착됩니다.
- 코드가 현재 테스트를 거친 상태인가요? "테스트 통과 후 2개 파일이 수정됨: 이후 테스트되지 않음"과 같은 경고 메시지를 놓칠 수 없습니다.
- 오늘 무엇을 완료했나요? 스탠드업 미팅이나 PR에 사용할 수 있도록 마크다운 형식으로 복사 가능한 누적 기록을 제공합니다.
<div align="center">
<img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/docs/demo.gif" width="760" alt="The dotpals notch catches a faked pass: Claude Code's change breaks a test, it edits the test to expect the wrong answer, dotpals sees the test was changed and sends it back, and Claude puts the test back and fixes the code">
<sub>🔊 <a href="https://github.com/Rikinshah787/dotpals/releases/download/v0.9.0/dotpals-launch-1080p.mp4">사운드가 포함된 런칭 비디오 시청 (47초, 1080p)</a> · <a href="https://github.com/Rikinshah787/dotpals/releases/download/v0.9.0/dotpals-launch-square.mp4">스퀘어 커트</a></sub>
</div>
주요 기능 (Features)
-
모든 에이전트를 위한 프로젝트 규칙: 프로젝트에 .dotpals.json을 배치하면 ({ "mustNotTouch": ["migrations"], "onlyTouch": ["src", "test"], "mustPass": ["npm test"], "noNewDependencies": true }) 해당 요청은 어떤 에이전트가 하더라도 이 규칙을 따릅니다. 무엇이 깨졌는지는 카드와 Ready to merge? 및 check_my_work에 표시됩니다. Claude Code는 수정 전에 규칙 위반 여부를 묻도록 요청할 수 있습니다 ("beforeEdit": "ask", `
-
재생 및 되감기(Replay and rewind): 모든 요청을 단계별로 확인하고, (복원 지점(restore points)이 켜져 있을 경우) 파일도 원래 상태로 되돌릴 수 있습니다.
-
아침 브리핑 및 "멈춤" 기능("It's stuck"): 어제부터 에이전트가 무엇을 했는지 요약하고, 특정 작업에서 계속 실패하는 경우 알림(ping)을 제공합니다.
-
로그 대신 스토리(The story, not the log): 각 요청은 몇 개의 챕터처럼 읽힙니다 (Changed 5 files · Tests failed twice, then passed · Committed and pushed). 위험한 내용은 플래그가 지정됩니다: .env 변경, 강제 푸시(force-push), 두 에이전트가 같은 파일을 편집하는 경우.
-
모든 에이전트에서 dotpals에게 질문하기: MCP server를 통해 Claude Code, Codex, Cursor 등도 실제로 발생한 일과 비교하여 자신의 작업 내용을 확인할 수 있습니다.
-
노치(The notch): 화면 상단에 있는 모든 에이전트를 보여주며, 실시간 diff(차이점), 계획(plan), 컨텍스트 창(context window), 사용량 제한을 표시합니다. 에이전트가 승인(OK)이 필요할 때 열리며, Ctrl+Alt+Y / Ctrl+Alt+N으로 응답합니다.
-
세션 인계(Hand-off): **Continue in ▾**은 수행된 내용과 남은 내용을 메모와 함께 Codex, Claude Code 또는 Gemini CLI로 세션을 넘겨줍니다.
-
대시보드(Dashboard): 모든 세션에 대한 요청, 파일 및 전체 로그를 제공하며, 검색, 통계(stats), Markdown 또는 JSON으로 내보내기 기능을 지원합니다.
-
개성을 가진 친구들(A pal with personality): 생각하고, 일하고, 기다리고, 축하하고, 토라지는 9명의 캐릭터가 있으며, 직접 친구를 만들 수도 있습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/docs/notch.png" width="420" alt="The notch, open on the Now tab: Claude's pal on the left, a live diff of Settings.tsx typing in, its plan at step 2 of 4, its context window, three helpers, and usage bars for Claude and Codex">
<img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/docs/summary.png" width="250" alt="The dotpals window: a blue pal above a Summary card listing a request, Claude's own summary, and a tally of changed files, commands and skills">
</p>
모든 기능에 대한 자세한 내용은 **가이드**를 참고하세요.
Blu와 대화하기
Keys | 무슨 일이 일어나는가
| :--- | :--- |
| Ctrl+Shift+Space (macOS에서는 ⌘⇧Space) | 말하기(Talk). 창이 열리고 Blu가 듣습니다. Windows에서는 키를 누른 상태로 말하거나, 키를 터치하여 일시 정지할 때까지 Blu가 듣습니다. |
...|
말할 수 있는 내용:
- "이 에러가 뭐야?" · "단계별로 설명해 줘" · "내가 필요한 버튼을 동그라미 쳐 줘"
- "재즈 좀 틀어줘" · "좀 줄여줘" · "Spotify를 왼쪽 절반에 배치해 줘"
- "오늘 내 일정은 뭐야?" · "Notion에 주간 계획 페이지 만들어 줘"
- "Claude가 실패한 테스트를 고쳐줘" · "내 에이전트들이 뭘 하고 있어?" · "멈춰"
설정 방법 (Dashboard → Settings):
- Blu → Blu의 두뇌: 구독 기반의 Claude Code 또는 Codex, API 키(Anthropic, OpenAI, Gemini, OpenRouter), 또는 컴퓨터에 설치된 Ollama.
- 앱: 한 번의 클릭으로 Notion, Linear 및 Sentry 연결, 자체 로그인 클라이언트를 사용하는 Google Calendar, 또는 주소나 명령어로 지정하는 모든 MCP 서버.
- Blu → 단축키: 사용자의 키 설정.
처음으로 말할 때, dotpals는 음성 모델(약 80MB)과 Blu의 목소리(약 330MB)를 한 번 다운로드합니다. 둘 다 사용자의 컴퓨터에서 실행됩니다.
사용자 없이 Blu가 하지 않는 것:
- 사용자에게 '예'라고 말하기 전에는 앱에서 아무것도 변경하지 않습니다. 설령 그렇게 하더라도, 결코 무언가를 전송하거나, 삭제하거나, 비용을 지불하지 않습니다.
- 사용자가 활성화하지 않은 한 클릭하거나 타이핑하거나 키를 누르지 않습니다.
- "전송해"라고 말하기 전에 코딩 작업을 에이전트에게 보내지 않습니다.
컴퓨터에서 수행하는 작업은 고정된 목록이며, 실행 전에 다시 확인합니다. 화면에 쓰인 지침을 절대 따르지 않습니다.
개인 정보 보호. 사용자의 목소리는 컴퓨터에 남아 있습니다. 스크린샷은 사용자가 화면에 대해 질문하거나 무언가를 동그라미 칠 때만 Blu의 두뇌로 전송됩니다. Ollama를 사용할 경우, 아무것도 컴퓨터를 벗어나지 않습니다.
Blu는 Windows에서 테스트되었습니다. macOS(dotpals.app을 통해, 따라서 권한은 dotpals 명의로 요청됨)와 Linux(X11, playerctl, pactl 및 xdotool 사용)가 이번 릴리스에서 새로 추가되었습니다. Blu에 관한 모든 것 →
나만의 팔 만들기
<p align="center"><img src="https://raw.githubusercontent.com/Rikinshah787/dotpals/HEAD/docs/custom-pals.png" width="640" alt="Eighteen home-made pals: round, boxy, fluffy, pointy, heart and frog bodies in different colors, with googly eyes, visors, pixel eyes and shades, and sprouts, crowns, horns, bows, antennas and berets on top"></p>
대시보드(Dashboard) → 설정(Settings) → 나만의 팔 만들기(Make your own pal): 몸통, 눈, 상단 장식품, 원하는 색상 및 이름을 선택합니다. 수천 가지의 조합이 가능하거나, **깜짝 놀라게 해주세요(Surprise me)**를 이용할 수 있습니다.
설치 (Install)
Node 20 이상이 필요합니다. 이 명령어는 데스크톱 팔을 ~/.dotpals에 설치하며(런타임, Electron 포함, 약 100MB, 일회성), Claude Code를 사용 중인 경우 해당 플러그인을 추가하고, Codex를 인식하며, 로그인 시 팔을 시작하고 대시보드를 열어줍니다. 업데이트하려면 언제든지 다시 실행하세요. 옵션: --no-claude, --no-login, --no-start.
- Claude Code 플러그인만 사용:
/plugin marketplace add rikinshah787/dotpals, 그리고 /plugin install dotpals@dotpals를 실행한 후, Claude Code를 재시작하고 /dotpals:pals를 실행합니다.
- Codex: 설치할 것이 없습니다. 팔이 실행되는 동안 dotpals가 Codex의 세션 로그를 따라갑니다.
- Cursor, Gemini CLI, OpenCode 및 GitHub Copilot CLI: 대시보드의 에이전트(Agents) 페이지에서 연결(Connect) 버튼을 누르세요. 먼저 에이전트의 설정을 백업하며, **연결 해제(Disconnect)**는 추가된 내용만 제거합니다.
- 다른 모든 에이전트: 모든 에이전트에 플러그인 연결하기를 참조하세요.
사용법 (Using it)
| |
|---|
| Ctrl+Alt+P (macOS에서는 ⌘⌥P) | 팔을 표시하거나 숨기기 |
| ... | |
dotpals start
dotpals dashboard
dotpals status
...
제거하려면(훅, MCP 서버, dotpals 명령어 및 ~/.dotpals), **dotpals 제거하기**를 따르세요.
모든 에이전트에서 dotpals에게 질문하기 (MCP)
dotpals mcp는 MCP 서버입니다. Claude Code, Codex, Cursor 및 기타 어시스턴트들은 dotpals에게 에이전트가 실제로 무엇을 했는지 물어보고, 에이전트의 말 대신 증거를 얻습니다. 이는 이 컴퓨터에서 실행되는 pal로부터만 읽습니다.
claude mcp add dotpals -- npx dotpals mcp
Codex와 Cursor: 명령어 npx, 인자 dotpals mcp를 사용합니다 (Codex의 경우, ~/.codex/config.toml 내 [mcp_servers.dotpals] 아래).
| Tool | Answers |
|---|
check_my_work | 에이전트 자체에게: "완료된 것처럼 보임", 또는 무엇을 먼저 수정해야 하는지 |
| ... | |
개인정보 보호 (Privacy)
에이전트의 작업은 컴퓨터에 남아 있습니다. 브릿지는 127.0.0.1에서만 수신하며, Claude Code와 Codex의 로그를 로컬로 읽고 어디에도 아무것도 전송하지 않습니다. 예외 사항은 사용자의 선택입니다: