준비물 : 클로드 Opus 5.5 xhigh
만들 것
Windows용 데스크톱 앱 "[앱 이름]"을 처음부터 만들어 줘.
내 PC에 이미 설치되고 로그인된 코딩 에이전트 CLI들(Claude Code, Codex, Gemini CLI, Grok CLI, OpenCode,
그리고 ACP를 지원하는 다른 에이전트)을 한 창에서 동시에 돌리고 지켜보는 "대시보드 + 터미널" 앱이야.
핵심 흐름: 프로젝트 → 스레드(대화) → 타임라인 + 입력창 → 변경 diff → 터미널 → git.
기술 스택
- Electron 셸 + Node 서버(utilityProcess) + React/Vite/Tailwind UI. 서버와 UI는 WebSocket 하나로 통신하고,
UI는 서버 API만 쓰는 클라이언트라서 일반 브라우저에서도 열려야 해.
- 전부 TypeScript. DB는 node:sqlite, 터미널은 node-pty(ConPTY) + xterm.
- 서버는 127.0.0.1에만 열고, 실행할 때마다 바뀌는 토큰으로만 접속.
- 패키징은 electron-builder (압축 안 푼 폴더 + 설치본).
에이전트 연결 방식 (가장 중요)
- CLI 화면을 긁지 말고 각 CLI의 공식 기계용 프로토콜로 연결해:
Claude Code = stream-json 제어 프로토콜, Codex = app-server(JSON-RPC), Gemini/Grok/OpenCode = ACP.
- 프로바이더마다 드라이버 하나: 감지(설치 경로·버전·로그인 상태·모델 목록), 세션 시작/이어하기,
승인 요청 처리, 사용량 한도, 업데이트 명령.
- 구현 전에 각 CLI의 실제 프로토콜을 내 PC의 CLI로 직접 조사하고, 의존성 없는 작은 probe 스크립트로
검증한 뒤 docs/research/providers/<이름>.md에 정리해. 프로토콜을 추측으로 만들지 마.
- 모델 목록은 하드코딩하지 말고 CLI가 주는 목록을 그대로 써(캐시해서 다음 실행엔 바로 보이게).
- "감지되면 보여준다": 검사가 느리거나 실패해도 설치된 프로바이더는 숨기지 말고 경고와 함께 보여주고,
왜 그런지(경로, 버전, 로그인 출처)를 카드에 설명해.
기능
1차 (MVP):
- 프로젝트 추가, 스레드 생성, 프로바이더/모델/추론 강도 선택
- 스트리밍 타임라인(도구 호출 카드, 이미지), 입력창(파일·이미지 첨부), 작업 중 끼어들기/대기열
- 승인 요청 카드(허용/거부)와 에이전트 질문에 답하기
- 변경 파일 diff, 내장 터미널, git 상태/커밋, 스레드별 git worktree 옵션
- 설정 > 프로바이더: 감지 결과, 로그인 상태, 업데이트 버튼
2차:
- 여러 스레드를 한눈에 보는 대시보드, "확인 필요" 모아보기, 데스크톱 알림·트레이
- 사용량 한도 표시, 한도가 풀리면 이어서 실행
- 하위 에이전트: 한 스레드가 다른 에이전트에게 일을 맡기고 결과를 받음(자식 스레드로 표시, MCP 브리지)
- Anthropic 호환 모델 API(DeepSeek, Kimi, GLM, OpenRouter, 직접 입력 URL)를 Claude Code를 통해 에이전트로 쓰기.
키는 Windows DPAPI로 암호화 저장, 에이전트별 설정 폴더 분리.
- 휴대폰 원격(같은 와이파이, QR 연결, 기본은 꺼짐)
- 프롬프트 템플릿/스킬(/이름), 프로젝트 메모리
- CLI 새 버전 알림(npm 최신 버전 확인 → 제목줄 종 아이콘)
- 기존 CLI 대화 기록 불러오기(읽기 전용)
꼭 지킬 규칙
- 비밀값(토큰, API 키)은 화면·로그·파일 어디에도 출력하거나 복사하지 마. 자격 증명 파일은
있는지/만료/이메일·플랜 같은 비밀 아닌 정보만 읽어.
- 내 에이전트 설정 폴더(~/.claude, ~/.codex, ~/.gemini, ~/.grok 등)에서 로그인/로그아웃하거나 수정하지 마.
기존 대화 기록은 읽기만 해.
- 승인을 약하게 만들지 마(사용자가 고른 것만 자동 허용).
- 저장소 안 설정 파일이 명령을 자동 실행하지 못하게 해: 사용자가 신뢰한 버전(해시)일 때만 실행.
- 휴대폰 원격 말고는 LAN에 열지 마.
- Windows: shell:false, 창 숨김, 인자 배열, 프로세스 트리 단위 종료, UTF-8, 경로에 한글·공백이 있어도 동작,
.cmd/.bat 직접 실행 금지.
- 서버 이벤트 루프를 막지 마(동기 자식 프로세스 금지). 쉬는 동안 CPU 거의 0(폴링 대신 이벤트).
- 성능 목표: 토큰 → 화면 1프레임 이내, 스레드 전환 100ms 미만, 긴 대화도 버벅임 없이
(가상 스크롤, 도구 출력은 끝부분만 전송, 전체는 요청할 때).
- UI: 다크 기본, 촘촘하고 키보드 중심, 애니메이션 최소, 위로 스크롤해서 읽는 중이면 자동 스크롤 금지,
모든 문구 한국어 + 영어.
- 다른 앱의 코드는 복사하지 말고 아이디어만 참고해.
일하는 방식
- 먼저 조사하고 docs/ARCHITECTURE.md(구조, 모듈 간 계약, 규칙, 성능 목표)를 써서 요약해 보여준 뒤 구현을 시작해.
- 단계가 끝날 때마다 타입체크, 빌드, 테스트 통과를 확인해. 테스트는 가짜 프로바이더/가짜 API로 하고,
실제 유료 모델 호출은 내 허락 없이 하지 마.
- 테스트 스크립트와 임시 파일은 저장소 밖 임시 폴더에 두고, 직접 띄운 프로세스는 끝나면 전부 종료해.
- 내 PC의 보안 프로그램, 방화벽, 시스템 설정은 건드리지 마.
- 패키징 전에 앱이 켜져 있으면 끄라고 말해줘.
- 커밋/푸시는 내가 말할 때만.
- 답은 쉬운 한국어로 짧게: 무엇을 바꿨는지, 확인한 것, 확인 못 한 것.
1차 완료 기준
설치된 CLI가 자동으로 감지되어 목록에 뜨고, 아무 프로바이더로나 새 스레드를 만들어 대화하고,
승인 카드에 답하고, diff와 터미널을 볼 수 있으면 1차 완료야.
기능을 추가할 때 :
[기능]을 추가해줘.
왜 필요한지: [이유]
완료 기준: [이렇게 되면 끝]
테스트는 가짜 프로바이더로 하고, 끝나면 확인한 것과 못 한 것을 알려줘.
버그를 알릴 때 :
증상: [무슨 일이 생기는지]
언제: [어떤 프로바이더/어떤 동작에서]
기대: [원래 어떻게 돼야 하는지]
오류 문구: [화면에 뜬 글자 그대로]
원인부터 찾아서 쉽게 설명하고, 고치기 전에 한 줄로 알려줘.
어떤 분의 말씀이 떠오르네요....
~~"모델이 문제가 아니라 너그들 프롬프팅 실력이 문제다"~~
