Skip to content

ADHDev 소개 ​

코딩 에이전트를 위한 컨트롤 플레인.

Claude Code, Codex, Cursor CLI — Mac, Windows 박스, 홈 서버에서 실행되고 있습니다. ADHDev가 이것들을 모두 조율합니다: 병렬로 태스크를 디스패치하고, 휴대폰에서 승인하고, Refinery가 모든 브랜치를 안전하게 main에 착지시키게 두세요.

📸 [스크린샷: 여러 머신에서 동시에 실행 중인 에이전트 세션들을 보여주는 ADHDev 대시보드]

에이전트는 이미 가지고 있습니다. ADHDev는 그 위의 레이어입니다 — 모든 세션을 보고, 여유 용량이 있는 머신에 작업을 보내고, 터미널 하나에 붙어 있지 않아도 완료된 브랜치를 머지합니다.

네 가지 핵심 기둥 ​

1. Refinery — 작업 착지 ​

병렬 에이전트 열 개를 스폰하는 것은 쉽습니다. 열 개의 브랜치를 머지하는 것이 어렵습니다. Refinery는 레포 자체의 게이트(타입체크, 테스트, 린트)로 각 워크트리를 검증하고, 패치 동등성을 확인하고, 서브모듈 커밋을 게시하고, 완료된 작업을 main 위로 리베이스한 뒤 그사이 main이 움직이지 않았을 때만 머지하고, 워크트리를 정리합니다 — 자동으로.

왜 중요한가: 이것이 벤더 도구들이 당신에게 맡기는 부분입니다. 그들은 워크트리를 만들고 멈춥니다. ADHDev는 main까지 끝까지 가져갑니다 — 그리고 절대 force-push를 하지 않습니다. 모호한 것은 강제로 처리하는 대신 사람의 검토로 돌아옵니다.

2. 모든 에이전트, 자유롭게 혼합 ​

설계 기반 벤더 중립. Mac에서 Claude Code, Windows 박스에서 Codex, 리뷰 패스로 Cursor CLI를 실행하세요 — 동일한 메시에서, 동일한 정책 아래.

왜 중요한가: 모든 벤더는 자체 에이전트만 제공합니다. ADHDev는 플랫폼을 바꾸지 않고도 에이전트를 혼합하고 전환할 수 있게 합니다.

3. 당신의 머신 ​

P2P 우선. Mac, Windows 박스, Linux 서버가 단일 컨트롤 플레인이 됩니다. 채팅·명령·스크린샷은 WebRTC를 통해 브라우저와 데몬 사이에서 직접 흐릅니다. 클라우드는 인증과 시그널링 메타데이터만 처리합니다.

왜 중요한가: 작업은 이미 소유하고 신뢰하는 하드웨어에서 실행됩니다. alt-tab으로 이동해야 하는 분산된 터미널이 아니라 하나로 조율됩니다.

4. 원격 제어 + HITL ​

휴대폰에서 도구 호출을 승인하세요. P2P 연결로 세션을 조종하세요. session-host 스택을 통해 데몬 재시작 후에도 장기 실행 세션을 유지하세요.

왜 중요한가: 사람의 결정이 종종 병목입니다. ADHDev는 승인과 상태를 당신이 있는 곳으로 라우팅하여, 책상 앞에 없었다는 이유로 대기 중인 에이전트가 20분을 허비하지 않게 합니다.

누구를 위한 것인가 ​

여러 머신에서 여러 코딩 에이전트를 실행하며 "완료됐나? 막혔나? 한 시간 전에 승인이 필요했던 건 아닌가?"를 확인하기 위해 터미널 사이를 alt-tab으로 이동하는 데 지친 개발자.

두 가지 실행 방법:

  • Standalone — AGPL, 계정 불필요, localhost:3847에서 완전히 실행됩니다. 앞에 있는 머신(과 LAN의 나머지)을 위한 완전한 로컬 대시보드.
  • 클라우드 — 계정 연결 멀티머신 관리(네트워크 밖의 머신 포함), 푸시 알림, 원격 접근 — adhf.dev. 어디서든 모든 머신에 접근하세요.

무엇이 다른가 ​

병렬 에이전트는 쉽습니다. 작업을 착지시키는 것이 어렵습니다. ADHDev가 어려운 부분을 합니다.

대부분의 도구는 더 많은 에이전트를 시작하는 것을 도와줍니다. ADHDev는 완료 후에 무슨 일이 일어나는지에 맞춰 설계되었습니다 — 사용하는 모든 머신과 모든 벤더에 걸쳐 실제 검증된 작업을 main으로 안전하게 돌려보내는 것.

실제 사례: 이 레포의 최근 7-태스크 프로토콜 마이그레이션이 Mac과 Windows 워커에 걸쳐 개발되었으며, 모든 브랜치가 Refinery를 통해 main에 착지했습니다 — 검증되고, 패치 확인되고, 리베이스 후 머지되고, 정리되어.

시작하기 ​

호스팅 클라우드 문서는 여기에 있습니다. 오픈소스 및 셀프호스트 문서는 OSS 레포지토리에 있습니다.