호환성 및 주의사항
ADHDev는 광범위한 내장 프로바이더 인벤토리를 제공하지만, 호환성은 여전히 보수적으로 읽어야 합니다. 이 페이지는 특정 워크플로우에 의존하기 전에 기대치를 설정하는 가장 빠른 방법입니다.
인벤토리 우선, 검증 두 번째
다음 규칙을 따르세요:
- 내장은 프로바이더가 출시된 인벤토리에 존재한다는 의미입니다.
- 검증은 프로바이더가 수동으로 테스트되고 프로모션되었다는 의미입니다.
- 프로바이더가 프로모션될 때까지 런처, 문서, 또는 기능 페이지에 나타나더라도 미검증으로 취급하세요.
실용적인 시작점
실제 사용을 위해 ADHDev를 평가하고 있다면, 단순한 인벤토리 존재가 아닌 이미 공개 Partial 증거가 있는 프로바이더로 시작하세요.
IDE 워크플로우
- Cursor
Cursor는 현재 IDE 스타일 제어, Remote View, 세션 전환을 위한 가장 명확한 공개 시작점입니다.
익스텐션 워크플로우
- Codex 익스텐션
이것은 현재 가장 강력한 공개 증거가 있는 익스텐션 경로입니다. 다른 익스텐션은 인벤토리나 런처 표면에 나타날 수 있지만, 프로모션될 때까지 탐색적인 것으로 취급해야 합니다.
CLI 워크플로우
- Claude Code
- Codex CLI
이들은 호스팅 PTY/세션-호스트 스택을 통해 실행되며, 보통 원격 모니터링 및 복구 흐름을 검증하는 가장 쉬운 곳입니다.
알려진 주의사항
IDE 지원은 Electron 우선
ADHDev는 IDE 제어를 위해 Chrome DevTools Protocol에 의존합니다. 즉, Electron 기반 IDE가 현재 주요 대상입니다.
- 오늘 Electron 우선 대상 세트: Cursor, Windsurf, Kiro, PearAI, Antigravity, Trae
- 감지/실행 커버리지: VS Code, VSCodium
- 현재 적합하지 않음: Zed, IntelliJ, 유사한 네이티브 데스크탑 앱 같은 비 Electron IDE
VS Code 계열은 Cursor/Windsurf와 다릅니다
VS Code와 VSCodium은 감지하고 실행할 수 있지만, 네이티브 통합 AI IDE와 동일하지 않습니다. Cline, Roo Code, Codex, 또는 Claude Code 같은 익스텐션 흐름을 추가하면 훨씬 더 관련성이 높아집니다.
Trae는 실제 주의사항이 있습니다
Trae는 채팅과 제어에 작동하지만, 모델 및 모드 컨트롤은 여전히 일반 UI 상호작용에 의존하며 앱 버전과 레이아웃에 따라 실패할 수 있습니다.
실제로:
- 채팅 읽기 작동
- 메시지 전송 작동
- Remote View 작동
- 모델 전환과 모드 전환은 부분적으로 취급해야 함
일부 ACP 에이전트는 업스트림 실험적 플래그에 의존합니다
일부 ACP 어댑터는 자체 도구에서 여전히 실험적으로 표시된 업스트림 기능에 의존합니다.
- Gemini CLI (ACP)는 현재
--experimental-acp로 시작합니다 - Qwen Code (ACP)는 현재
--experimental-skills로 시작합니다
이들은 여전히 유용할 수 있지만, 기본적으로 안전한 선택이 아닌 실험적인 것으로 취급해야 합니다.
인증은 여전히 도구별입니다
ADHDev는 각 도구의 자체 로그인 흐름을 대체하지 않습니다.
- CLI 및 ACP 에이전트는 여전히 자체 API 키나 로그인 상태가 필요합니다
- API 키 누락은 아직 기본 도구를 인증하지 않은 경우 실행 실패처럼 보일 수 있습니다
- 이는 Gemini, Claude, Codex, 많은 ACP 에이전트에 특히 중요합니다
푸시 알림은 플랫폼에 따라 다릅니다
푸시 알림은 대시보드가 PWA로 설치되어 있을 때 가장 잘 작동합니다.
- iOS는 웹 푸시를 위한 PWA 설치 경로가 필요합니다
- 알림 액션 버튼은 모든 플랫폼에서 일관되게 표시되지 않습니다
- 액션 버튼이 제공되지 않더라도 알림 자체는 도달할 수 있습니다
Windows는 현재 Node.js 24+를 차단합니다
ADHDev는 현재 일반 npm/전역 CLI 설치 및 시작에서 Windows + Node.js 24+ 를 지원하지 않는 것으로 처리합니다.
- PowerShell 원라인 설치 프로그램은 이 조합을 감지하면 이제 휴대용 Node.js 22 런타임을 부트스트랩합니다
- Windows에서 직접
npm install -g adhdev를 사용할 계획이라면 Node.js 22.x를 사용하세요 - 이는 Windows PTY/세션-호스트 경로가 최신 Node 릴리스에서 안정화될 때까지의 임시 보호 조치입니다
Linux는 아직 인벤토리 우선입니다
일부 문서 및 인벤토리 표에 Linux가 언급되는 것은 출시된 프로바이더/감지기 인벤토리가 Linux 지향 프로세스 이름, 포트, Unix 스타일 명령 경로를 포함하기 때문입니다.
이것을 아직 공개 지원 약속으로 읽어서는 안 됩니다.
- 현재 공개 설치 테스트 경로는 macOS와 Windows입니다
- Linux는 아직 지원되는 경로로 제시하기에 충분히 검증되지 않았습니다
- 오늘 Linux에서 실험한다면 미검증으로 취급하고 수동 문제 해결을 예상하세요
클라우드 vs 스탠드얼론 기대치
클라우드
다음이 필요할 때 클라우드를 사용하세요:
- 로컬 네트워크 외부에서의 접근
- 푸시 알림
- 멀티 머신 관리
- API 키와 웹훅
스탠드얼론
다음이 필요할 때 스탠드얼론을 사용하세요:
- 로컬 전용 설정
- 클라우드 의존성 없음
- LAN 기반 모니터링 및 제어
스탠드얼론은 OSS 사용자와 로컬 팀에 훌륭하지만, 푸시 알림과 인터넷 facing 원격 접근 같은 클라우드 전용 기능은 해당 경로의 일부가 아닙니다.
오늘 보통 가장 잘 작동하는 것
제품의 가장 대표적인 첫인상을 원한다면 다음이 여전히 가장 안전한 시작 경로입니다:
- 모바일 승인이나 Remote View와 함께 선택적으로 데스크탑의 Cursor
- 익스텐션 워크플로우를 원한다면 지원되는 호스트 IDE 내의 Codex 익스텐션
- 대시보드 터미널을 통한 Claude Code 또는 Codex CLI
- 기본 사항이 안정적으로 느껴질 때까지 먼저 한 대의 머신에 하나의 IDE, 그 다음 멀티 머신
현재 상태 확인 위치
현재 프로모션 목록과 카테고리별 상태는 지원 프로바이더를 사용하세요. 해당 페이지는 단순히 인벤토리에 있는 것과 명시적인 검증이 있는 것에 대한 공개 레퍼런스입니다.