ADHDev란?
ADHDev는 로컬 코딩 에이전트를 위한 제어 플레인입니다.
각 머신에 데몬을 실행하고, 이미 있는 CLI 에이전트(Claude Code, Codex, Cursor CLI, 또는 PTY 에이전트)에 연결하며, 웹에서 제어하고, 머신에 걸쳐 확장하며, main에 안전하게 작업을 반영할 수 있는 단일 공간을 제공합니다.
세 가지 핵심 축
1. 로컬 CLI 에이전트의 웹 제어
브라우저나 폰에서 CLI 에이전트를 구동하세요: 터미널을 건드리지 않고도 프롬프트를 보내고, 툴 콜을 승인하며, 세션을 조종합니다. v1 Provider SDK는 PTY CLI, CDP IDE 세션을 연결합니다 — 벤더 중립으로 설계되었습니다.
2. Repo Mesh + Refinery (병렬 오케스트레이션)
여러 머신의 격리된 git 워크트리에 걸쳐 태스크를 병렬로 디스패치합니다. Refinery는 각 워크트리를 저장소 자체 게이트(타입체크, 테스트, 린트)에 맞게 검증하고, 패치 동등성을 확인하며, 서브모듈 커밋을 게시하고, 완료된 작업을 main 위로 리베이스한 뒤 그사이 main이 움직이지 않았을 때만 머지하고, 정리합니다 — 자동으로. 절대로 force-push 없이.
3. P2P 우선 — 코드는 머신에 유지
채팅, 명령어, 스크린샷, 파일 작업은 WebRTC를 통해 브라우저와 데몬 사이에서 직접 흐릅니다. 서버는 인증·시그널링·간단한 상태 요약을 처리합니다. 의도된 예외가 하나 있습니다: 클라우드 에디션에서 푸시 알림을 만들기 위해 승인 프롬프트(명령과 버튼 문구)를 받고, 알림에는 그중 80자까지 실립니다.
두 가지 실행 방법
| 모드 | 설명 |
|---|---|
| Standalone (OSS) | AGPL, 계정 불필요. 완전히 localhost:3847에서 실행됩니다. 앞에 있는 머신(및 LAN의 나머지)을 위한 완전한 로컬 대시보드. |
| Cloud (adhf.dev) | 계정 연결 멀티 머신 관리, 푸시 알림, 원격 접근. 어디서든 모든 머신에 접근. |
어떤 경우에 어떤 것을 사용할까
- Standalone — 로컬 개발 워크플로우, LAN 전용 접근, 클라우드 계정 의존성 없음(서로 직접 닿는 머신끼리는 페어링 가능), 또는 셀프호스트 자동화
- Cloud — 계정 연결 멀티 머신 플릿, LAN 외부 원격 접근, 모바일 승인