Add v0, Cowork, and CODEX_CI agent detection (#12)

Author: pushpak1300

README.md

@@ -52,17 +52,19 @@ $result = detectAgent();
 | Custom | `AI_AGENT` env var |
 | Cursor | `CURSOR_AGENT` env var |
 | Gemini | `GEMINI_CLI` env var |
-| Codex | `CODEX_SANDBOX` or `CODEX_THREAD_ID` env var |
+| Codex | `CODEX_SANDBOX`, `CODEX_CI`, or `CODEX_THREAD_ID` env var |
 | Augment CLI | `AUGMENT_AGENT` env var |
 | AMP | `AMP_CURRENT_THREAD_ID` env var |
 | Opencode | `OPENCODE_CLIENT` or `OPENCODE` env var |
 | Claude | `CLAUDECODE` or `CLAUDE_CODE` env var |
+| Cowork | `CLAUDE_CODE_IS_COWORK` with `CLAUDECODE` or `CLAUDE_CODE` env var |
 | Copilot | `AI_AGENT=github-copilot`, `AI_AGENT=github-copilot-cli`, `COPILOT_MODEL`, `COPILOT_ALLOW_ALL`, `COPILOT_GITHUB_TOKEN`, or `COPILOT_CLI` env var |
 | Replit | `REPL_ID` env var |
 | Devin | `/opt/.devin` file exists |
 | Antigravity | `ANTIGRAVITY_AGENT` env var |
 | Pi | `PI_CODING_AGENT` env var |
 | Kiro CLI | `KIRO_AGENT_PATH` env var |
+| v0 | `AI_AGENT=v0` env var |
 
 ### Custom Agent
 

src/AgentDetector.php

@@ -25,7 +25,7 @@ public static function detect(): AgentResult
         $agentsWithEnvVars = [
             'cursor' => ['CURSOR_AGENT'],
             'gemini' => ['GEMINI_CLI'],
-            'codex' => ['CODEX_SANDBOX', 'CODEX_THREAD_ID'],
+            'codex' => ['CODEX_SANDBOX', 'CODEX_CI', 'CODEX_THREAD_ID'],
             'augment-cli' => ['AUGMENT_AGENT'],
             'opencode' => ['OPENCODE_CLIENT', 'OPENCODE'],
             'amp' => ['AMP_CURRENT_THREAD_ID'],
@@ -40,6 +40,10 @@ public static function detect(): AgentResult
         foreach ($agentsWithEnvVars as $agent => $envVars) {
             foreach ($envVars as $envVar) {
                 if (getenv($envVar) !== false) {
+                    if ($agent === 'claude' && getenv('CLAUDE_CODE_IS_COWORK') !== false) {
+                        return new AgentResult(true, 'cowork');
+                    }
+
                     return new AgentResult(true, $agent);
                 }
             }

src/KnownAgent.php

@@ -8,10 +8,12 @@ enum KnownAgent: string
 {
     case Cursor = 'cursor';
     case Claude = 'claude';
+    case Cowork = 'cowork';
     case Devin = 'devin';
     case Replit = 'replit';
     case Gemini = 'gemini';
     case Codex = 'codex';
+    case V0 = 'v0';
     case AugmentCli = 'augment-cli';
     case Opencode = 'opencode';
     case Amp = 'amp';

tests/AgentDetectorTest.php

@@ -13,13 +13,15 @@
         'CURSOR_AGENT',
         'GEMINI_CLI',
         'CODEX_SANDBOX',
+        'CODEX_CI',
         'CODEX_THREAD_ID',
         'AUGMENT_AGENT',
         'OPENCODE_CLIENT',
         'OPENCODE',
         'AMP_CURRENT_THREAD_ID',
         'CLAUDECODE',
         'CLAUDE_CODE',
+        'CLAUDE_CODE_IS_COWORK',
         'COPILOT_MODEL',
         'COPILOT_ALLOW_ALL',
         'COPILOT_GITHUB_TOKEN',
@@ -41,13 +43,15 @@
         'CURSOR_AGENT',
         'GEMINI_CLI',
         'CODEX_SANDBOX',
+        'CODEX_CI',
         'CODEX_THREAD_ID',
         'AUGMENT_AGENT',
         'OPENCODE_CLIENT',
         'OPENCODE',
         'AMP_CURRENT_THREAD_ID',
         'CLAUDECODE',
         'CLAUDE_CODE',
+        'CLAUDE_CODE_IS_COWORK',
         'COPILOT_MODEL',
         'COPILOT_ALLOW_ALL',
         'COPILOT_GITHUB_TOKEN',
@@ -94,6 +98,16 @@
         ->and($result->knownAgent())->toBe(KnownAgent::Copilot);
 });
 
+it('detects v0 via AI_AGENT', function (): void {
+    putenv('AI_AGENT=v0');
+
+    $result = AgentDetector::detect();
+
+    expect($result->isAgent)->toBeTrue()
+        ->and($result->name)->toBe('v0')
+        ->and($result->knownAgent())->toBe(KnownAgent::V0);
+});
+
 it('does not detect an agent when AI_AGENT is not set', function (): void {
     $result = AgentDetector::detect();
 
@@ -132,6 +146,16 @@
         ->and($result->knownAgent())->toBe(KnownAgent::Codex);
 });
 
+it('detects codex via CODEX_CI', function (): void {
+    putenv('CODEX_CI=true');
+
+    $result = AgentDetector::detect();
+
+    expect($result->isAgent)->toBeTrue()
+        ->and($result->name)->toBe('codex')
+        ->and($result->knownAgent())->toBe(KnownAgent::Codex);
+});
+
 it('detects codex via CODEX_THREAD_ID', function (): void {
     putenv('CODEX_THREAD_ID=some-thread-id');
 
@@ -202,6 +226,28 @@
         ->and($result->knownAgent())->toBe(KnownAgent::Claude);
 });
 
+it('detects cowork via Claude Code cowork env vars', function (): void {
+    putenv('CLAUDE_CODE=1');
+    putenv('CLAUDE_CODE_IS_COWORK=1');
+
+    $result = AgentDetector::detect();
+
+    expect($result->isAgent)->toBeTrue()
+        ->and($result->name)->toBe('cowork')
+        ->and($result->knownAgent())->toBe(KnownAgent::Cowork);
+});
+
+it('does not detect cowork without Claude Code', function (): void {
+    putenv('CLAUDE_CODE_IS_COWORK=1');
+
+    $GLOBALS['__mock_file_exists'] = fn (string $path): bool => false;
+
+    $result = AgentDetector::detect();
+
+    expect($result->isAgent)->toBeFalse()
+        ->and($result->name)->toBeNull();
+});
+
 it('detects copilot via COPILOT_MODEL', function (): void {
     putenv('COPILOT_MODEL=gpt-5.2');
 
@@ -303,22 +349,13 @@
 });
 
 // Priority order
-it('prioritizes AI_AGENT over CURSOR_TRACE_ID', function (): void {
+it('prioritizes AI_AGENT over CURSOR_AGENT', function (): void {
     putenv('AI_AGENT=custom');
-    putenv('CURSOR_TRACE_ID=trace');
-
-    $result = AgentDetector::detect();
-
-    expect($result->name)->toBe('custom');
-});
-
-it('prioritizes CURSOR_TRACE_ID over CURSOR_AGENT', function (): void {
-    putenv('CURSOR_TRACE_ID=trace');
     putenv('CURSOR_AGENT=true');
 
     $result = AgentDetector::detect();
 
-    expect($result->name)->toBe('cursor');
+    expect($result->name)->toBe('custom');
 });
 
 it('prioritizes CURSOR_AGENT over CLAUDECODE', function (): void {
@@ -390,6 +427,8 @@
     'cursor' => ['CURSOR_AGENT', '1', KnownAgent::Cursor],
     'gemini' => ['GEMINI_CLI', 'true', KnownAgent::Gemini],
     'codex' => ['CODEX_SANDBOX', 'true', KnownAgent::Codex],
+    'codex ci' => ['CODEX_CI', 'true', KnownAgent::Codex],
+    'v0' => ['AI_AGENT', 'v0', KnownAgent::V0],
     'augment-cli' => ['AUGMENT_AGENT', 'true', KnownAgent::AugmentCli],
     'opencode' => ['OPENCODE_CLIENT', 'true', KnownAgent::Opencode],
     'amp' => ['AMP_CURRENT_THREAD_ID', 'thread-id', KnownAgent::Amp],