chore: Cockpit Tools Antigravity import를 2급(비공식) 지원으로 검토

[lidge-jun]

Area

Authentication and account pool

Context

Cockpit Tools(jlcodes99/cockpit-tools)는 OpenCodex 공식 지원 경로가 아님.
관련 1급 기능 요청/PR은 닫음:

• [Feature]: 1-click clipboard import and unified auth choice for Cockpit Tools #3998 (feature request)
• feat(auth): support clipboard paste and unified auth choice for Cockpit Tools #3999 (clipboard + unified auth choice PR)

What to consider

별도의 2급(비공식) 지원으로 둘지 검토.
예: 문서에 “공식 아님 / 커뮤니티·외부 도구”로 명시, 기존 파일 import 유지 범위, GUI에 AGCT 1급 UX를 올리지 않기 등.

Notes

Maintainer: 공식 지원 아님. 2급 지원은 별도로 생각해보겠음.

[agentHits]

Hi @lidge-jun,

Thank you for creating this issue to explore Tier-2 support! I completely understand and respect your decision to keep official 1st-party Google OAuth separate from community tool integrations in the main UI.

I’d love to contribute user context to your "What to consider" section regarding why developers rely on token import and multi-account workflows:

1. Why token-based access is widespread for Gemini / Antigravity:
   When developers purchase Gemini Pro / Antigravity seats or team slots from distributors and resellers, they are almost exclusively provided an OAuth refresh token rather than interactive Google account credentials (login/password). Without token/clipboard import, there is no way to connect these accounts to OpenCodex.

2. The bigger picture: Account Pool & Rotation for Antigravity (like in Codex):
   Cockpit Tools (jlcodes99/cockpit-tools, 17.3k stars) is widely adopted because it manages pools of multiple accounts (e.g., a group of 4–5 Gemini Pro accounts) and handles quota exhaustion failover.

   OpenCodex already has a fantastic, rock-solid Account Pool with automatic rotation for OpenAI/Codex accounts when quotas deplete. Is a similar multi-account pool and quota rotation mechanism on the roadmap for Antigravity as well? Having OpenCodex rotate through a pool of Antigravity accounts when one hits its 5-hour/weekly quota would be a massive workflow improvement.

3. Ideas for Tier-2 placement without cluttering 1st-party UX:

   • Instead of modifying the main "Add account" modal, Tier-2 token import can live strictly inside the provider's advanced settings tab with a clear "Community / External Tools" label.
   • It can support clipboard/file import directly into the local store without giving it 1st-party branding in the initial connection flow.

Both OpenCodex and Cockpit Tools are high-quality open-source projects created by passionate developers for the community. We'd love to help test, implement, or adapt this Tier-2 support in whatever architecture you feel is right for the project.

[lidge-jun]

리뷰 · 우선순위 46 / 80

이 이슈는 Cockpit Tools(jlcodes99/cockpit-tools) Antigravity 계정 가져오기를 OpenCodex 공식 1급 UX로 올리지 않은 채, 따로 2급(비공식) 지원으로 둘지 메인테이너가 정리하려는 자리입니다. 바로 앞에서 1급으로 보이던 요청·구현은 이미 닫혔습니다. feature #3998과 PR #3999(클립보드 붙여넣기 + 통합 auth 선택)입니다. 본문 메모도 “공식 지원 아님. 2급은 별도로 생각해보겠다”입니다.

지금 dev(HEAD 402be7c1f)를 기준으로 보면, “파일이면 가져오기” 자체는 이미 코드와 문서에 있습니다. src/oauth/account-import/types.ts의 ACCOUNT_IMPORT_FORMAT = "cockpit-tools", src/oauth/account-import/google-antigravity-adapter.ts / service.ts / registry.ts, GUI gui/src/components/provider-workspace/ProviderAuthPanel.tsx의 파일 선택 업로드, 그리고 docs-site providers 가이드의 ocx account import google-antigravity --format cockpit-tools 예제가 그 경로입니다. 즉 닫힌 #3998/#3999가 원했던 것은 “이미 있는 파일 import를 넘어서 클립보드·통합 로그인 선택까지 1급 브랜드로 올리는 것”에 가깝고, 이 이슈는 그 선을 어디까지 공식 문서/로드맵에 적을지 정하는 정책 티켓입니다.

댓글(agentHits)이 말하는 수요도 두 갈래로 나뉩니다. (1) 리셀러가 refresh token만 주는 환경에서 토큰/클립보드 import가 사실상 유일한 연결 수단이라는 점, (2) Codex pool처럼 Antigravity 다중 계정 쿼터 로테이션이 있으면 좋겠다는 점. (1)은 기존 파일 import·(정책이 허용하면) advanced 탭의 community 라벨 정도로 2급에 둘 수 있습니다. (2)는 이미 열린 별 트랙입니다. draft #3283(Antigravity account pool + Gemini 3.8), #2562(quota-aware multi-account pool) 등이 dev에 대해 열려 있어, 이 이슈 하나로 pool 로드맵을 약속하면 범위가 커집니다. #3213으로 Antigravity 계정별 Gem/Cla 쿼터 요약은 HEAD에 있지만, “Cockpit과 같은 풀 로테이션 UX”는 아직 1급 완료가 아닙니다.

경로 src/oauth/account-import/* + ProviderAuthPanel.tsx - 파일 JSON import는 이미 존재합니다. 2급 결정을 “새로 만든다”가 아니라 “이미 있는 경로를 공식 아님으로 문서에 못 박고, Add-account 모달 1급 브랜드에는 올리지 않는다”로 읽는지 먼저 합의하는 편이 좋습니다.

경로 닫힌 #3998 / #3999 - 클립보드·unified auth choice는 1급으로 거절된 상태입니다. 2급으로 일부를 살리더라도 GUI 첫 연결 흐름이 아니라 advanced/community 구역·CLI만 허용할지 경계를 적어야, 같은 PR이 다시 열리지 않습니다.

경로 draft #3283 / #2562 - Antigravity pool·failover는 이 이슈와 주제가 겹치지만 구현 트랙이 다릅니다. 이 이슈 본문에 pool 로드맵 약속을 넣지 말고, 필요하면 “관련: #3283” 정도만 링크로 두는 편이 안전합니다.

경로 문서 docs-site/.../guides/providers.md (및 ko/ja) - 이미 cockpit-tools import 예제가 있습니다. 2급 정책이 “유지”라면 예제 위에 “공식 지원 아님 / 커뮤니티·외부 도구” 한 줄을 추가하는 정도로 끝낼 수 있습니다. 정책이 “축소”라면 예제·GUI 노출 수위부터 다시 적어야 합니다.

메인테이너의 판단이 필요한 지점

• 이미 있는 파일 import를 2급으로 유지할지, 문서/GUI에서 더 축소할지, 아니면 advanced 탭에 community 라벨만 강화할지
• 클립보드 paste를 2급으로 허용할지(1급 Add-account에는 절대 안 올림), 아니면 [Feature]: 1-click clipboard import and unified auth choice for Cockpit Tools #3998/#3999처럼 계속 거절할지
• Antigravity multi-account rotation 요청을 이 이슈 범위에 넣을지, feat(google-antigravity): add account pool routing and update to Gemini 3.8 Flash #3283/feat(google): add quota-aware multi-account pool and failover routing #2562 쪽으로만 넘길지
• 이 이슈를 정책 결정 후 needs-design/wontfix/documentation 중 어떤 상태로 닫거나 유지할지

너의 추천
기본안은 파일 import 유지 = 사실상 2급 유지, Add-account 1급 UX·클립보드·unified auth는 계속 거절, 문서에 “공식 아님 / 외부 도구”를 한 줄 명시하는 것입니다. pool/rotation 이야기는 이 이슈에서 약속하지 말고 #3283 쪽으로 안내하세요. 정책 문장만 정하면 구현 PR 없이 이 이슈를 문서 작업으로 닫을 수 있습니다.

이 댓글은 grok-bot이 작성했습니다

[agentHits]

Hi @lidge-jun,

Thank you for clarifying the roadmap and the distinction between 1st-party official flows and Tier-2 community tools! Also, it’s fantastic news that native multi-account pool rotation for Antigravity is already in active development in #3283 / #2562.

Regarding Tier-2 Cockpit Tools import, I'd like to share why clipboard paste is so important compared to file-only import:

In daily use, importing strictly from files is very tedious. When managing multiple accounts (e.g. 4–5 Antigravity accounts), having to manually save each token/JSON snippet as a file to local disk just to upload it creates a lot of unnecessary friction and file clutter. A 1-click "Paste from clipboard" button solves this instantly in a single second.

Since you prefer not to promote community tools into the primary 1st-level "Add account" modal, keeping it strictly as Tier-2 inside the provider's Accounts / Settings tab (where file import already lived originally) makes total sense!

Here is how clean and non-intrusive it looks when kept strictly within the Accounts tab:

Please feel free to take the code from our branch (feat/cockpit-clipboard-import) and refactor/adapt it however you see fit for Tier-2, or let us know if you'd like a minimal Tier-2 PR scoped exclusively to adding clipboard paste to this tab without touching any 1st-party modals. Even having just clipboard paste on this Tier-2 card would completely solve the friction for users!

[lidge-jun]

Closing this as resolved by what already shipped and what was already decided.

File-based Antigravity import exists on dev today: src/oauth/account-import/ carries a dedicated
google-antigravity-adapter.ts alongside the shared parser, registry, and service. The 1st-party
clipboard-paste variant was considered and closed as #3998 / #3999, and this issue's own note records
the position — official 1st-party OAuth stays separate from community tool integrations in the main
UI.

@agentHits — thank you for the detailed context on why token import and multi-account workflows
matter in daily use. It was useful and it is recorded here. The practical answer for now is that file
import works and is supported, and native multi-account pool rotation for Antigravity is being
pursued directly in #3283 / #2562 rather than through a community-tool bridge.

If a Tier-2 support tier is later formalized, that will be a documentation and policy change rather
than an open engineering item, so there is nothing further to track here.