프로바이더
ADHDev는 프로바이더 시스템을 통해 IDE, CLI 도구, 확장, ACP 어댑터를 하나의 대시보드에서 지원합니다.
프로바이더 인벤토리와 검증된 지원은 의도적으로 구분됩니다:
- 인벤토리: 프로바이더가 내장 카탈로그에 존재하고 ADHDev가 로드할 수 있음
- 검증된 지원: 프로바이더가 명시적으로 테스트되고 증거와 함께 승격됨
프로바이더 카테고리
| 카테고리 | 설명 | 예시 |
|---|---|---|
ide | 데스크탑 IDE 애플리케이션 | Cursor, VS Code, Windsurf |
cli | 터미널 기반 AI 에이전트 | Gemini CLI, Claude Code |
extension | IDE 확장/플러그인 | Cline, Roo Code |
acp | Agent Client Protocol 에이전트 | 35개 내장 어댑터 |
프로바이더 동작 방식
프로바이더는 ADHDev에게 다음을 알려주는 통합 레이어입니다:
- 대상 도구 감지
- CDP, PTY, 또는 stdio를 통한 연결
- 채팅 또는 런타임 상태 읽기
- 입력 또는 제어 작업 전송
- 도구가 지원하는 경우 모델, 모드, 승인 컨트롤 노출
이러한 동작이 실제로 "지원됨"이라고 부를 만큼 신뢰할 수 있는지는 별도의 검증 문제입니다.
사용자가 알아야 할 사항
최종 사용자로서 중요한 질문은 프로바이더가 어떻게 구현됐는지가 아닙니다. 다음을 확인하세요:
- 프로바이더가 내장 인벤토리에 있는가?
Verified,Partial,Unverified중 무엇으로 문서화됐는가?- 내가 사용하려는 워크플로에 어떤 주의사항이 있는가?
다음 페이지를 활용하세요:
CLI 및 ACP 프로바이더의 머신 활성화
머신 런타임 프로바이더(cli 및 acp)의 경우, 인벤토리에 존재하는 것이 특정 머신에서 실행 가능하다는 의미는 아닙니다. ADHDev는 이제 이러한 프로바이더를 머신별 옵트인 항목으로 처리합니다:
- 머신의 Providers 탭을 엽니다.
- 해당 머신에서 프로바이더를 활성화합니다.
- Detect를 실행하여 ADHDev가 해당 머신에서 설정된 실행 파일을 검증하도록 합니다.
- 감지에 성공하면 대시보드 또는 CLI에서 실행합니다.
프로바이더 카드는 현재 머신 상태(Disabled, Enabled, not checked, Not detected, Detected)와 최신 감지 및 검증 세부 정보를 표시합니다. 이를 통해 카탈로그에만 존재하는 프로바이더가 로컬 실행 파일이 실제로 확인될 때까지 사용 가능한 런타임으로 표시되는 것을 방지합니다.
커스텀 실행 파일 경로 및 인수는 머신별 프로바이더 설정입니다. 도구가 기본 PATH 밖에 설치됐거나 래퍼 명령이 필요한 경우에 사용하세요.
프로바이더 소스 설정
Providers 탭의 Provider source config 섹션은 프로바이더 정의를 어디서 불러올지 제어합니다:
normal: 일반 사용자 루트와 업스트림/번들 프로바이더를 로드합니다.no-upstream: 다운로드된 업스트림 소스를 건너뛰고 로컬/번들 정의만 사용합니다.explicit providerDir: ADHDev가 로컬adhdev-providers체크아웃과 같은 특정 프로바이더 루트를 가리키도록 합니다.
소스 모드 또는 providerDir 변경 후 Apply + Reload를 사용하세요. 리로드는 프로바이더 해석, 수정/검증 흐름, 새 실행에 영향을 줍니다. 변경된 프로바이더 스크립트를 반영하려면 실행 중인 세션을 재시작해야 할 수 있습니다.
프로바이더가 있어도 실패하는 경우
프로바이더가 인벤토리에 있어도 여전히 문제가 있을 수 있습니다.
일반적인 원인:
- IDE 또는 에이전트의 업스트림 UI 변경
- 부분적인 워크플로 커버리지
- 기반 도구의 인증 누락
- 존재하지만 여전히
Unverified상태인 프로바이더 - 활성화되지 않았거나 머신 감지를 통과하지 못한 CLI/ACP 프로바이더
- 아직 적용/리로드되지 않은 프로바이더 소스 설정 변경
이 경우 프로바이더 문제에서 시작하세요.