This project provides a composer package with a detector for detecting the presence of an agent.
Run
composer require ergebnis/agent-detector<?php
declare(strict_types=1);
use Ergebnis\AgentDetector;
$detector = new AgentDetector\Detector();
$isAgentPresent = $detector->isAgentPresent(\getenv());This package detects the presence of the following agents via environment variables:
| Agent | Environment Variable |
|---|---|
| Amp | AMP_CURRENT_THREAD_ID |
| Antigravity | ANTIGRAVITY_AGENT |
| Augment | AUGMENT_AGENT |
| Claude Code | CLAUDECODE, CLAUDE_CODE, CLAUDE_CODE_IS_COWORK |
| Codex | CODEX_CI, CODEX_SANDBOX, CODEX_THREAD_ID |
| Cursor | CURSOR_AGENT, CURSOR_EXTENSION_HOST_ROLE, CURSOR_TRACE_ID |
| Gemini CLI | GEMINI_CLI |
| GitHub Copilot | COPILOT_ALLOW_ALL, COPILOT_GITHUB_TOKEN, COPILOT_MODEL |
| OpenCode | OPENCODE, OPENCODE_CLIENT |
| Replit | REPL_ID |
In addition, the generic AI_AGENT environment variable can be set to indicate the presence of an agent.
The maintainers of this project record notable changes to this project in a changelog.
The maintainers of this project suggest following the contribution guide.
The maintainers of this project ask contributors to follow the code of conduct.
The maintainers of this project provide limited support.
This project currently supports the following PHP versions:
- PHP 7.4 (has reached its end of life on November 28, 2022)
- PHP 8.0 (has reached its end of life on November 26, 2023)
- PHP 8.1 (has reached its end of life on December 31, 2025)
- PHP 8.2
- PHP 8.3
- PHP 8.4
- PHP 8.5
The maintainers of this project add support for a PHP version following its initial release and may drop support for a PHP version when it has reached its end of life.
This project has a security policy.
This project uses the MIT license.
The agent detector is inspired by shipfastlabs/agent-detector, originally licensed under MIT by Pushpak Chhajed.
Follow @localheinz and @ergebnis on Twitter.