feat(cli): expand AI agent detection (#1261)

* feat(cli): expand AI agent detection to cover Cline, Codex CLI, Gemini CLI, and OpenCode

Add detection for four new AI coding agents that were missing compared
to similar tooling (e.g. Stripe CLI). Also add CURSOR_AGENT as a
fallback env var for Cursor detection alongside the existing
CURSOR_TRACE_ID.

New operators and their env vars:
- Cline: CLINE_ACTIVE
- Codex CLI: CODEX_SANDBOX, CODEX_THREAD_ID
- Gemini CLI: GEMINI_CLI
- OpenCode: OPENCODE
- Cursor (additional): CURSOR_AGENT

* fix(cli): move VS Code check after all agent checks

Cline (and potentially other future agents) are VS Code extensions,
so TERM_PROGRAM=vscode is always set when they're active. The previous
ordering would misclassify Cline as 'vscode' (interactive) instead of
'cline' (agent). Moving the VS Code check after all agent-specific
checks ensures extensions are correctly detected as agents.

Author: MichaelHogers

packages/cli/src/helpers/__tests__/cli-mode.spec.ts

@@ -2,8 +2,9 @@ import { beforeEach, describe, expect, it } from 'vitest'
 import { detectOperator, detectCliMode } from '../cli-mode'
 
 const operatorEnvVars = [
-  'CLAUDECODE', 'CURSOR_TRACE_ID', 'TERM_PROGRAM', 'GITHUB_COPILOT',
-  'AIDER', 'WINDSURF', 'CODEIUM_ENV', 'GITHUB_ACTIONS', 'GITLAB_CI', 'CI',
+  'CLAUDECODE', 'CURSOR_TRACE_ID', 'CURSOR_AGENT', 'TERM_PROGRAM', 'GITHUB_COPILOT',
+  'AIDER', 'WINDSURF', 'CODEIUM_ENV', 'CLINE_ACTIVE', 'CODEX_SANDBOX', 'CODEX_THREAD_ID',
+  'GEMINI_CLI', 'OPENCODE', 'GITHUB_ACTIONS', 'GITLAB_CI', 'CI',
 ]
 
 describe('detectOperator', () => {
@@ -20,11 +21,16 @@ describe('detectOperator', () => {
     expect(detectOperator()).toBe('claude-code')
   })
 
-  it('detects Cursor', () => {
+  it('detects Cursor via CURSOR_TRACE_ID', () => {
     process.env.CURSOR_TRACE_ID = 'some-trace-id'
     expect(detectOperator()).toBe('cursor')
   })
 
+  it('detects Cursor via CURSOR_AGENT', () => {
+    process.env.CURSOR_AGENT = '1'
+    expect(detectOperator()).toBe('cursor')
+  })
+
   it('detects VS Code', () => {
     process.env.TERM_PROGRAM = 'vscode'
     expect(detectOperator()).toBe('vscode')
@@ -65,11 +71,42 @@ describe('detectOperator', () => {
     expect(detectOperator()).toBe('gitlab-ci')
   })
 
+  it('detects Cline', () => {
+    process.env.CLINE_ACTIVE = '1'
+    expect(detectOperator()).toBe('cline')
+  })
+
+  it('detects Codex CLI via CODEX_SANDBOX', () => {
+    process.env.CODEX_SANDBOX = '1'
+    expect(detectOperator()).toBe('codex-cli')
+  })
+
+  it('detects Codex CLI via CODEX_THREAD_ID', () => {
+    process.env.CODEX_THREAD_ID = 'thread-123'
+    expect(detectOperator()).toBe('codex-cli')
+  })
+
+  it('detects Gemini CLI', () => {
+    process.env.GEMINI_CLI = '1'
+    expect(detectOperator()).toBe('gemini-cli')
+  })
+
+  it('detects OpenCode', () => {
+    process.env.OPENCODE = '1'
+    expect(detectOperator()).toBe('opencode')
+  })
+
   it('detects generic CI', () => {
     process.env.CI = 'true'
     expect(detectOperator()).toBe('ci')
   })
 
+  it('prioritizes Cline over VS Code (Cline is a VS Code extension)', () => {
+    process.env.CLINE_ACTIVE = '1'
+    process.env.TERM_PROGRAM = 'vscode'
+    expect(detectOperator()).toBe('cline')
+  })
+
   it('prioritizes Claude Code over CI', () => {
     process.env.CLAUDECODE = '1'
     process.env.CI = 'true'
@@ -118,6 +155,26 @@ describe('detectCliMode', () => {
     expect(detectCliMode()).toBe('agent')
   })
 
+  it('returns "agent" when operator is cline', () => {
+    process.env.CLINE_ACTIVE = '1'
+    expect(detectCliMode()).toBe('agent')
+  })
+
+  it('returns "agent" when operator is codex-cli', () => {
+    process.env.CODEX_SANDBOX = '1'
+    expect(detectCliMode()).toBe('agent')
+  })
+
+  it('returns "agent" when operator is gemini-cli', () => {
+    process.env.GEMINI_CLI = '1'
+    expect(detectCliMode()).toBe('agent')
+  })
+
+  it('returns "agent" when operator is opencode', () => {
+    process.env.OPENCODE = '1'
+    expect(detectCliMode()).toBe('agent')
+  })
+
   it('returns "ci" when operator is github-actions', () => {
     process.env.GITHUB_ACTIONS = 'true'
     expect(detectCliMode()).toBe('ci')

packages/cli/src/helpers/cli-mode.ts

@@ -4,6 +4,7 @@ const VALID_CLI_MODES: ReadonlySet<string> = new Set(['interactive', 'ci', 'agen
 
 const AGENT_OPERATORS: ReadonlySet<string> = new Set([
   'claude-code', 'cursor', 'windsurf', 'aider', 'github-copilot',
+  'cline', 'codex-cli', 'gemini-cli', 'opencode',
 ])
 
 const CI_OPERATORS: ReadonlySet<string> = new Set([
@@ -12,11 +13,15 @@ const CI_OPERATORS: ReadonlySet<string> = new Set([
 
 export function detectOperator (): string {
   if (process.env.CLAUDECODE) return 'claude-code'
-  if (process.env.CURSOR_TRACE_ID) return 'cursor'
-  if (process.env.TERM_PROGRAM === 'vscode') return 'vscode'
+  if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_AGENT) return 'cursor'
   if (process.env.GITHUB_COPILOT) return 'github-copilot'
   if (process.env.AIDER) return 'aider'
   if (process.env.WINDSURF || process.env.CODEIUM_ENV) return 'windsurf'
+  if (process.env.CLINE_ACTIVE) return 'cline'
+  if (process.env.CODEX_SANDBOX || process.env.CODEX_THREAD_ID) return 'codex-cli'
+  if (process.env.GEMINI_CLI) return 'gemini-cli'
+  if (process.env.OPENCODE) return 'opencode'
+  if (process.env.TERM_PROGRAM === 'vscode') return 'vscode'
   if (process.env.GITHUB_ACTIONS) return 'github-actions'
   if (process.env.GITLAB_CI) return 'gitlab-ci'
   if (process.env.CI) return 'ci'