agent-detector
May 7, 2026 ยท View on GitHub
This project provides a composer package with a detector for detecting the presence of an agent.
Installation
Run
composer require ergebnis/agent-detector
Usage
Detecting the presence of an agent
<?php
declare(strict_types=1);
use Ergebnis\AgentDetector;
$detector = new AgentDetector\Detector();
$isAgentPresent = $detector->isAgentPresent(\getenv());
Supported agents
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_CLI, COPILOT_GITHUB_TOKEN, `COPILOT_MODEL |
| OpenCode | OPENCODE, OPENCODE_CLIENT |
| Pi | PI_CODING_AGENT |
| Replit | REPL_ID |
Indicating the presence of an agent
In addition, the generic AI_AGENT environment variable can be set to indicate the presence of an agent.
Changelog
The maintainers of this project record notable changes to this project in a changelog.
Contributing
The maintainers of this project suggest following the contribution guide.
Code of Conduct
The maintainers of this project ask contributors to follow the code of conduct.
General Support Policy
The maintainers of this project provide limited support.
PHP Version Support Policy
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.
Security Policy
This project has a security policy.
License
This project uses the MIT license.
Credits
The agent detector is inspired by shipfastlabs/agent-detector, originally licensed under MIT by Pushpak Chhajed.
Social
Follow @localheinz and @ergebnis on Twitter.