aibridge은(는) 무엇을 하나요?
aibridge는 다른 제공업체의 모델을 구동할 수 있게 해줍니다. 이 머신에 설치된 AI CLI를 실행하고 그 출력을 검증합니다. 사용자가 판단과 프롬프트 제작을 담당하고, CLI는 깨지기 쉬운 실행을 담당합니다. 위임을 통해 사용자가 가지고 있지 않을 수 있는 것(다양한 훈련과 사각지대(실제 교차 검증), 이미지 렌더링, 고부하 추론 시트)을 가져오며, 백킹 CLI의 기존 로그인 상태에서 동시에 실행되므로 API 키가 필요하지 않습니다. 각 위임은 해당 백킹 CLI 자체의 할당량을 사용합니다(할당량이 사용자 소유인 경우는 모델 시트(Model seats) 참조).
실행 방법
aibridge <command> [options] # `aibridge`가 PATH에 있는 경우
npx -y @aibridge/cli <command> [options] # 설치 불필요 — 어디서나 작동
설치 단계가 필요하지 않습니다. 두 번째 형식은 npm에서 요청 시 CLI를 가져옵니다. 아래 참조 문서는 모든 명령을 aibridge <command>로 작성합니다. aibridge가 PATH에 없으면 aibridge 대신 npx -y @aibridge/cli를 사용하고, 나머지는 모두 동일합니다. Node ≥24.11이 필요합니다.
설정(설치가 아닌 일회성 확인)
- 최소 CLI 버전: 0.1.0.
- 확인:
aibridge --version을 실행합니다. 명령어가 없으면npx -y @aibridge/cli --version을 실행하고 그때부터 npx 형식을 사용합니다. 출력된 버전을0.1.0(semver)과 비교합니다. - npx를 통해 최소 버전 미만(캐시 만료):
npx -y @aibridge/cli@latest로 다시 실행합니다. 전역 설치를 통해 최소 버전 미만: 사용자에게npm i -g @aibridge/cli로 업데이트를 제안합니다. node --version이24.11미만인 경우: CLI를 실행할 수 없습니다. 사용자에게 Node 업그레이드를 요청합니다(예:nvm install 24/mise use node@24).- 선택 사항으로,
aibridge명령어를 PATH에 직접 추가하려는 사용자를 위해:npm i -g @aibridge/cli. 전역 설치를 실행하기 전에 사용자에게 물어보십시오.
PATH에 백킹 CLI가 설치되고 인증되어 있어야 합니다: grok(권장 플래너/리뷰어 — 명시적으로 전달), agy(권장 구현자 — 명시적으로 전달), codex(권장 이미지 생성 시트 — 명시적으로 전달, openai-codex/* 위임 포함), 선택적으로 anthropic-claude/* 위임 계층을 위한 claude.
서브커맨드
| 명령어 | 설명 | 참조 |
|---|---|---|
plan | 작업을 상세한 구현 계획 파일로 확장 | reference/plan.md |
implement | 계획 파일을 제자리에서 구현(작업 트리 편집, 실제 게이트 실행) | reference/implement.md |
review | 작업 트리 diff(또는 계획)를 계약에 대해 검토 | reference/review.md |
subagent | 독립적인 작업을 다른 모델에 위임 | reference/subagent.md |
image-gen | 모델 시트(codex, agy 또는 grok 백엔드)를 통해 래스터 이미지 생성 | reference/image-gen.md |
runs | 실행 모니터링 및 검사 | — |
quota | 백엔드 할당량 및 초기화 시간 표시(grok, agy, codex, claude) | — |
models | 레지스트리의 모든 모델 시트 나열(slug, 노력 수준, 이미지 형식) | — |
라우팅
-
첫 단어가 서브커맨드 이름인 경우 → 해당 참조 파일을 로드하고 따릅니다. 이것은 협상 불가 사항입니다: 참조 파일에는 출력을 좋게 만드는 프롬프트 제작 기술이 포함되어 있습니다. 건너뛰면 일반적인 결과가 생성됩니다.
-
서브커맨드가 제공되지 않은 경우 → 요청에서 유추:
- 이미지 / 아이콘 / 그래픽 제작 →
image-gen; - 다른 모델에 맡기기 위한 명확하게 지정된 독립적인 작업, 또는 교차 모델 두 번째 의견 / 레드팀 →
subagent; - 크거나 위험한 구현 작업 → 세 가지 동사 워크플로우:
plan→ 사용자가 계획 파일을 읽고, 편집하고, 승인 →implement→review --plan <file>. 위험도가 높은 설계의 경우 구현 전 게이트를 추가: 깨끗한 트리에서review --plan은 계획 자체를 검토합니다.
진정으로 모호한 경우 위의 표를 보여주고 물어보십시오.
- 이미지 / 아이콘 / 그래픽 제작 →
-
현재 플래그를 모르는 경우?
aibridge <command> --help를 실행하십시오. 표면은 시간이 지남에 따라 증가합니다(새 모델, 새 플래그).
모델 시트(권장 선택 — 명시적으로 전달)
모든 명령에 --model이 필요합니다. 아무것도 자동으로 선택되지 않습니다. 대략적인 시작점 — 벤치마크가 아니며, 일반적으로 작동하는 경향이 있습니다:
| slug | plan | implement | review | image-gen |
|---|---|---|---|---|
xai-grok/grok-4.5 | ✅ 소형-중형, 범위가 명확함 | ✅ 모든 정확도 | ✅ | ○ JPEG |
openai-codex/gpt-5.6-sol | ✅ 중형-대형, 모호함 | ○ | ✅ | ✅ PNG |
anthropic-claude/opus-5 | ✅ 중형-대형, 모호함 | ○ | ✅ | ✗ |
google-antigravity/gemini-3.6-flash | ○ | ✅ 고-최고 상세도 필요 | ○ | ○ JPEG |
anthropic-claude/sonnet-5 | ○ | ✅ 높은 상세도 필요 | ○ | ✗ |
✅ 권장 · ○ 작동함 · ✗ 지원 안 함. plan의 경우 자격은 시트가 흡수하는 모호함의 정도입니다. implement의 경우 계획이 얼마나 명확해야 하는지입니다.
이는 대략적인 권장 사항이며 측정값이 아닙니다. 작업이 행에 명확하게 맞지 않거나 사용자가 작업을 라우팅하는 방법을 말한 경우, 추측하지 말고 사용자에게 물어보십시오.
기타 등록된 시트, 동일한 규칙: openai-codex/gpt-5.6-terra / -luna(더 저렴한 코딩 계층), anthropic-claude/fable-5(가장 어렵고 오래 실행되는 작업), anthropic-claude/haiku-4-5(빠른 답변), google-antigravity/gemini-3.1-pro(-high/-low만 해당), 그리고 agy의 claude-sonnet-4-6 / claude-opus-4-6-thinking / gpt-oss-120b-medium — Antigravity 할당량에서 Claude 및 GPT 수준의 작업을 수행하며, 이는 동일 제공업체 시트가 사용자가 피하려는 것일 때 중요합니다. 정확한 시트별 정보(허용되는 노력 수준, 이미지 형식, 고정 모델 ID)를 보려면 aibridge models [--json]을 실행하십시오. aibridge <command> --help는 모든 시트를 나열합니다.
- grok은 강력하게 제한됩니다(~30 req/min, ~1k msgs/day;
aibridge quota는 주간 크레딧 사용량을 추적합니다). 한 번에 하나의 grok 단계만 실행하십시오. 모호한 브리프를 용납하는 유일한 시트이므로, 상세한 계획이 이미 있는 곳보다는 입력이 불명확한 곳에 사용하십시오. - 리뷰어를 구현자와 다른 모델로 유지하십시오. 모델이 자신의 diff를 검토하면 자신의 사각지대를 공유합니다. 권장 시트는 이미 다릅니다. 하나의 시트를 재정의하는 경우 다른 시트도 확인하십시오. 동일한 논리가 사용자에게도 적용됩니다. 사용자가 직접 작성한 작업의 경우 사용자 자신의 모델 패밀리 외부의 리뷰어를 선호하십시오.
- 할당량은 오케스트레이터 기준입니다. 모든 백엔드는 자체 CLI의 로그인/할당량을 사용합니다. 이 스킬을 실행하는 에이전트와 할당량을 공유하는 백엔드(
anthropic-claude/*는 Claude 기반 에이전트의 경우 — claude CLI의 구독에 청구됨,google-antigravity/*는 Antigravity 기반 에이전트의 경우, …)는 최후의 수단입니다. 사용하기 전에 그렇게 말하십시오. - 할당량에 따라 시트 교체:
openai-codex/gpt-5.6-sol[-<effort>](자체 ChatGPT 로그인)는 모든 시트에 대한 일반적인 대안입니다. - 할당량 사전 점검은 모든 위임 전에 자동으로 실행됩니다.
aibridge quota는 파이프라인을 계획할 때 수동으로 2초 안에 확인하는 방법입니다.
보안 및 신뢰 모델
- aibridge는 설계상 실제 위임을 수행합니다. 도구 모드에서 백킹 CLI는 파일을 읽고 쓰고 셸을 실행합니다. 이는 이 스킬을 실행하는 에이전트와 동일한 신뢰 수준입니다. 여기서 사용자가 에이전트와 해당 CLI를 설치하고 인증할 때 이미 부여한 권한보다 더 많은 접근 권한을 부여하는 것은 없습니다.
- 위임은 작업 프롬프트(및 위임 대상이 읽기로 선택한 모든 것)를 백킹 CLI의 제공업체로 보냅니다. 사용자가 해당 제공업체에 보내고 싶지 않은 콘텐츠를 위임하지 마십시오. 신뢰할 수 없는 입력에는
--no-tools를 사용하십시오. 위임 대상은 파일이나 셸 접근 권한을 얻지 못하고 추론만 수행합니다. - CLI는 npm의
@aibridge/cli이며, 공개 리포지토리(https://github.com/ycmjason/aibridge)의 OIDC를 통해 SLSA 증명과 함께 게시됩니다. 해당 패키지에는 설치 시간 스크립트가 없으며 감사할 수 있는 단일 런타임 종속성 트리가 있습니다. - 사용자가 이 스킬을 설치하고 CLI가 자체 계정에서 npx/npm을 통해 실행될 때까지 아무것도 실행되지 않습니다.