프로바이더
ADHDev는 프로바이더 시스템을 통해 IDE, CLI 도구, 확장을 하나의 대시보드에서 지원합니다.
프로바이더 인벤토리와 검증된 지원은 의도적으로 구분됩니다:
- 인벤토리: 프로바이더가 내장 카탈로그에 존재하고 ADHDev가 로드할 수 있음
- 검증된 지원: 프로바이더가 명시적으로 테스트되고 증거와 함께 승격됨
프로바이더 카테고리
| 카테고리 | 설명 | 예시 |
|---|---|---|
ide | 데스크탑 IDE 애플리케이션 | Cursor, VS Code, Windsurf |
cli | 터미널 기반 AI 에이전트 | Cursor CLI, Claude Code |
extension | IDE 확장/플러그인 | Cline, Roo Code |
프로바이더 동작 방식
프로바이더는 ADHDev에게 다음을 알려주는 통합 레이어입니다:
- 대상 도구 감지
- CDP, PTY, 또는 stdio를 통한 연결
- 채팅 또는 런타임 상태 읽기
- 입력 또는 제어 작업 전송
- 도구가 지원하는 경우 모델, 모드, 승인 컨트롤 노출
이러한 동작이 실제로 "지원됨"이라고 부를 만큼 신뢰할 수 있는지는 별도의 검증 문제입니다.
사용자가 알아야 할 사항
최종 사용자로서 중요한 질문은 프로바이더가 어떻게 구현됐는지가 아닙니다. 다음을 확인하세요:
- 프로바이더가 내장 인벤토리에 있는가?
Verified,Partial,Unverified중 무엇으로 문서화됐는가?- 내가 사용하려는 워크플로에 어떤 주의사항이 있는가?
다음 페이지를 활용하세요:
프로바이더 소스 설정
Providers 탭의 Provider source config 섹션은 프로바이더 정의를 어디서 불러올지 제어합니다:
normal: 일반 사용자 루트와 업스트림/번들 프로바이더를 로드합니다.no-upstream: 다운로드된 업스트림 소스를 건너뛰고 로컬/번들 정의만 사용합니다.explicit providerDir: ADHDev가 로컬adhdev-providers체크아웃과 같은 특정 프로바이더 루트를 가리키도록 합니다.
소스 모드 또는 providerDir 변경 후 Apply + Reload를 사용하세요. 리로드는 프로바이더 해석, 수정/검증 흐름, 새 실행에 영향을 줍니다. 변경된 프로바이더 스크립트를 반영하려면 실행 중인 세션을 재시작해야 할 수 있습니다.
CLI 모델 목록과 쿼터
CLI 프로바이더의 경우, 기반 도구가 지원하는 경우 모델 목록과 남은 쿼터 수치는 수동 관리가 아니라 실시간으로 읽습니다:
- 모델 목록: codex-cli, grok-cli, cursor-cli, antigravity-cli, opencode, kimi는 실행 시 자체 모델 목록을 보고합니다(조회에 실패하면 매니페스트로 폴백). claude-cli는 목록 조회 명령이 없어 매니페스트 목록을 그대로 사용합니다.
- 쿼터:
adhdev quota <provider>는 antigravity, codex, grok, kimi에 대해 프로바이더 자체의 사용량 API를 실시간으로 조회합니다. Claude Code는statusLine훅을 통해서만 사용량을 노출하므로, 이에 대한 쿼터 리포팅은 데몬이 자동으로 수행하는 것이 아니라 명시적인 옵트인 래퍼(adhdev quota claude:install)가 필요합니다. 전체 명령 표면은 CLI 명령어를 참고하세요.
자동 승인과 신뢰 프롬프트
자동 승인 모드는 리포지토리 수준 기본값을 가진 프로바이더별 매니페스트 선언 설정입니다 — 버튼을 하나씩 누르는 대시보드 흐름 없이 프로바이더 자체의 승인/신뢰 프롬프트에 응답합니다. 커버리지와 동작은 프로바이더마다 다릅니다(버튼 레이아웃과 신뢰 모달 문구가 CLI마다 다름). 따라서 자동 승인을 단일한 균일 스위치가 아니라 프로바이더별 기능으로 취급하세요.
프로바이더가 있어도 실패하는 경우
프로바이더가 인벤토리에 있어도 여전히 문제가 있을 수 있습니다.
일반적인 원인:
- IDE 또는 에이전트의 업스트림 UI 변경
- 부분적인 워크플로 커버리지
- 기반 도구의 인증 누락
- 존재하지만 여전히
Unverified상태인 프로바이더 - 활성화되지 않았거나 머신 감지를 통과하지 못한 CLI 프로바이더
- 아직 적용/리로드되지 않은 프로바이더 소스 설정 변경
이 경우 프로바이더 문제에서 시작하세요.