agent

Overview ¶

Package agent detects whether the Go SQL driver is being invoked by an AI coding agent by checking for well-known environment variables that agents set in their spawned shell processes.

Detection only succeeds when exactly one agent environment variable is present, to avoid ambiguous attribution when multiple agent environments overlap.

Adding a new agent requires only a new constant and a new entry in knownAgents.

References for each environment variable:

• ANTIGRAVITY_AGENT: Closed source. Google Antigravity sets this variable.
• CLAUDECODE: https://github.com/anthropics/claude-code (sets CLAUDECODE=1)
• CLINE_ACTIVE: https://github.com/cline/cline (shipped in v3.24.0)
• CODEX_CI: https://github.com/openai/codex (part of UNIFIED_EXEC_ENV array in codex-rs)
• CURSOR_AGENT: Closed source. Referenced in a gist by johnlindquist.
• GEMINI_CLI: https://google-gemini.github.io/gemini-cli/docs/tools/shell.html (sets GEMINI_CLI=1)
• OPENCODE: https://github.com/opencode-ai/opencode (sets OPENCODE=1)