A lightweight utility for detecting if code is being executed by an AI agent or automated development environment.
Installation
npm install @vercel/detect-agent
Usage
import { determineAgent } from '@vercel/detect-agent';const { isAgent, agent } = await determineAgent();if (isAgent) { console.log(`Running in ${agent.name} environment`); // Adapt behavior for AI agent context}
Supported Agents
This package can detect the following AI agents and development environments:
Custom agents via AI_AGENT environment variable
Cursor (cursor editor and cursor-cli)
Claude Code (Anthropic's Claude)
Devin (Cognition Labs)
Gemini CLI (Google)
Codex (OpenAI)
OpenCode (via OPENCODE=1 or OPENCODE_CLIENT)
Antigravity (Google DeepMind)
GitHub Copilot (via AI_AGENT=github-copilot|github-copilot-cli, COPILOT_MODEL, COPILOT_ALLOW_ALL, or COPILOT_GITHUB_TOKEN)
Replit (online IDE)
v0 (Vercel's AI assistant, via AI_AGENT=v0)
fx (Vercel's agent harness, via AI_AGENT=fx)
eve (Vercel's agent framework, via AI_AGENT=eve)
The AI_AGENT Standard
We're promoting AI_AGENT as a universal environment variable standard for AI development tools. This allows any tool or library to easily detect when it's running in an AI-driven environment.
For AI Tool Developers
Set the AI_AGENT environment variable to identify your tool:
import { determineAgent } from '@vercel/detect-agent';async function setupEnvironment() { const { isAgent, agent } = await determineAgent(); if (isAgent) { // Running in AI environment - adjust behavior process.env.LOG_LEVEL = 'verbose'; console.log(`🤖 Detected AI agent: ${agent.name}`); }}
Telemetry and Analytics
import { determineAgent } from '@vercel/detect-agent';async function trackUsage(event: string) { const result = await determineAgent(); analytics.track(event, { agent: result.isAgent ? result.agent.name : 'human', timestamp: Date.now(), });}
Feature Toggles
import { determineAgent } from '@vercel/detect-agent';async function shouldEnableFeature(feature: string) { const result = await determineAgent(); // Enable experimental features for AI agents if (result.isAgent && feature === 'experimental-ai-mode') { return true; } return false;}