[Feature]: add Cline as a supported client integration

[lidge-jun]

Area

Multiple areas

What are you trying to accomplish?

Use Cline with OpenCodex the way the other supported clients already work: OpenCodex writes the client's provider configuration, keeps the model catalog in sync, and can roll the change back, so switching Cline between routed providers does not mean hand-editing Cline settings.

Requested on X by @Splaxi on 2026-09-09: "would you consider adding cline support in open codex?" (https://x.com/splaxi/status/2097811410809979099).

What prevents this today?

Cline is not a known integration. src/integrations/registry.ts at dev 6d3ad12e3 (2.51.0) enumerates opencode, pi, omp, hermes, openclaw, kimi, gajae, dsh, mcode, zcode, prime, aside, and raycast alongside the native Codex and Claude surfaces, and ocx integration client operates on that registry. A Cline user has to point Cline at the proxy manually and re-do it whenever routing, port, or the model set changes, with no detection, no catalog sync, and no rollback entry.

What should OpenCodex do?

1. Detect an installed Cline configuration the way the existing integrations detect theirs.
2. Write the OpenAI-compatible base URL and key into Cline's settings through the same atomic writer and rollback journal the other integrations use.
3. Sync the routed catalog so the models offered inside Cline match what the proxy will actually serve.
4. Expose it through the existing verbs and the dashboard client list, with no new special-case surface.

Example usage or interface

ocx integration client list        # cline appears with a detected install path
ocx integration client enable cline
ocx integration client restore cline

Alternatives or workarounds

Configure Cline by hand against http://127.0.0.1:<port>/v1 with a manually copied key, and re-do it after every routing or catalog change. That works, but it is exactly the manual sync the integration registry exists to remove.

Additional context

• Related client-integration work: 添加提供方-账户 新增zcode登录 #4189 (zcode login), PR feat(clients): add native Command Code integration and catalog sync #3833 (native Command Code integration and catalog sync).
• The pattern to follow is whichever existing registry entry is closest to Cline's settings shape; this proposal does not ask for a new mechanism.

Checks

• I searched existing issues and documentation.
• This request describes a concrete OpenCodex workflow rather than merely naming a desired technology.
• I removed secrets and personal data.

[lidge-jun]

리뷰 · 우선순위 60 / 80

이 이슈는 Cline을 다른 지원 클라이언트처럼 OpenCodex 통합으로 다루고 싶다는 요청이다. 감지 → 설정 기록 → 카탈로그 동기화 → 롤백이 한 줄로 되게 해서, 포트/키/모델이 바뀔 때마다 Cline 설정을 손으로 고치지 않게 하자는 말이다. X @Splaxi 요청에서 왔다.

현재 dev HEAD 6101140ff(2.51.0)에서 src/integrations/registry.ts의 IntegrationClientId는 ExportClientId 별칭(약 49행)이고, INTEGRATION_CLIENTS에는 opencode, pi, omp, hermes, openclaw, kimi, gajae, dsh, mcode, zcode, prime, aside, raycast만 있다. cline은 없다. 같은 목록이 src/clients/config-export.ts의 EXPORT_CLIENTS에도 있다. 그래서 ocx integration client list/enable/restore 경로에 Cline이 나타나지 않고, 사용자는 http://127.0.0.1:<port>/v1에 키를 수동으로 넣는 우회만 한다.

feasibility L5 #4214는 이번 라운드를 CLI/registry + EXPORT_CLIENTS만으로 좁혔다. 대시보드 탭은 후속이다. 패턴은 기존 writer/journal(src/integrations/writer.ts, state.ts)을 그대로 쓰고, Cline 설정 파일 형태에 가장 가까운 항목을 본뜨면 된다. 관련으로 열려 있는 #3833은 제목이 native Command Code(command-code) 통합·카탈로그 동기화이고, registry에는 이미 mcode 항목이 있다. Cline과는 클라이언트가 다르니 구현을 합치지 말고, 카탈로그 동기화·writer 패턴만 참고하면 된다. 겹치는 PR이 같은 파일(registry.ts / config-export.ts)을 만지면 머지 순서만 조심하면 된다.

경로/심볼 - src/integrations/registry.ts INTEGRATION_CLIENTS (~159+): cline 항목 없음
경로/심볼 - src/integrations/registry.ts IntegrationClientId (~49): ExportClientId 별칭
경로/심볼 - src/clients/config-export.ts EXPORT_CLIENTS: 동일 클라이언트 집합, cline 없음
경로/심볼 - src/integrations/writer.ts / state.ts: enable/restore·카탈로그 기록 경로 (재사용)
이슈 - #3833 (OPEN): Command Code(mcode) 쪽; Cline과 클라이언트는 별개, 패턴만 공유

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

• Cline 설정 경로/포맷(VS Code 확장 vs CLI) 중 어느 설치를 1차로 감지할지
• L5에서 대시보드 클라이언트 목록 노출을 정말 다음으로 미룰지 (feasibility는 미룸)
• #3833과 registry.ts/EXPORT_CLIENTS 동시 수정 시 랜딩 순서
• Cline이 OpenAI-compatible base URL만 받으면 되는지, 모델 목록 동기화까지 1차에 넣을지

너의 추천
L5 레인: EXPORT_CLIENTS + INTEGRATION_CLIENTS에 cline을 추가하고 CLI ocx integration client enable/restore/list만 이번 라운드에 넣어라. 대시보드 탭은 후속 이슈로 남겨라. #3833과 파일을 공유하면 Command Code 랜딩 뒤를 따르거나, 충돌 시 close-don't-rebase가 아니라 작은 registry 충돌만 해소하면 된다. 지금 구현을 넓혀 types/config 캠페인까지 끌어오지 마라.

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

[lidge-jun]

Landed via #4371 at 81f6cd5

Cline CLI/shared SDK 감지, journaled catalog sync, dashboard/가이드 항목이 dev에 들어왔습니다. #3833(Command Code)은 별건으로 남겨 둡니다. Closing as landed.