agents.json

{
  "$schema": "./agents.schema.json",
  "version": 1,
  "description": "Language-agnostic specification for detecting AI agents and automated development environments. Agents are evaluated in array order; the first agent whose `match` condition is satisfied wins. Every agent's `match` is a combinator (`anyOf`/`allOf`) whose `conditions` are evaluated as a tree: combinators nest, and `env_set`/`env_value`/`file_exists` are leaf checks. See agents.schema.json for the full structure.",
  "aiAgentVar": "AI_AGENT",
  "agents": [
    {
      "key": "CURSOR",
      "name": "cursor",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "CURSOR_TRACE_ID" }]
      }
    },
    {
      "key": "CURSOR_CLI",
      "name": "cursor-cli",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "CURSOR_AGENT" },
          {
            "type": "env_value",
            "name": "CURSOR_EXTENSION_HOST_ROLE",
            "value": "agent-exec"
          }
        ]
      }
    },
    {
      "key": "KIMI",
      "name": "kimi",
      "description": "Kimi Code plugin hooks. KIMI_CODE_HOME may be configured outside an active Kimi session, so detection uses the plugin-scoped KIMI_PLUGIN_ROOT marker.",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "KIMI_PLUGIN_ROOT" }]
      }
    },
    {
      "key": "GROK",
      "name": "grok",
      "description": "Grok Build plugin hooks. Evaluated before Claude Code because Grok supports Claude Code plugins and may expose compatibility markers.",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "GROK_PLUGIN_ROOT" },
          { "type": "env_set", "name": "GROK_PLUGIN_DATA" }
        ]
      }
    },
    {
      "key": "GEMINI",
      "name": "gemini_cli",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "GEMINI_CLI" }]
      }
    },
    {
      "key": "CLINE",
      "name": "cline",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "CLINE_ACTIVE" }]
      }
    },
    {
      "key": "CODEX",
      "name": "codex_cli",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "CODEX_SANDBOX" },
          { "type": "env_set", "name": "CODEX_CI" },
          { "type": "env_set", "name": "CODEX_THREAD_ID" },
          { "type": "env_set", "name": "CODEX_SANDBOX_NETWORK_DISABLED" }
        ]
      }
    },
    {
      "key": "ANTIGRAVITY",
      "name": "antigravity",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "ANTIGRAVITY_AGENT" },
          { "type": "env_set", "name": "ANTIGRAVITY_CLI_ALIAS" }
        ]
      }
    },
    {
      "key": "AUGMENT_CLI",
      "name": "augment-cli",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "AUGMENT_AGENT" }]
      }
    },
    {
      "key": "OPENCODE",
      "name": "open_code",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "OPENCODE_CLIENT" },
          { "type": "env_set", "name": "OPENCODE" }
        ]
      }
    },
    {
      "key": "GOOSE",
      "name": "goose",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "GOOSE_PROVIDER" }]
      }
    },
    {
      "key": "JUNIE",
      "name": "junie",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "JUNIE_DATA" },
          { "type": "env_set", "name": "JUNIE_SHIM_PATH" }
        ]
      }
    },
    {
      "key": "PI",
      "name": "pi",
      "description": "Matches when the PATH contains a '.pi/agent' (or '.pi\\\\agent') segment.",
      "match": {
        "type": "anyOf",
        "conditions": [
          {
            "type": "env_matches",
            "name": "PATH",
            "pattern": "\\.pi[\\\\/]agent"
          }
        ]
      }
    },
    {
      "key": "COWORK",
      "name": "cowork",
      "description": "Claude Cowork. Evaluated before `claude_code` so the more specific COWORK marker wins. Requires CLAUDE_CODE_IS_COWORK plus a Claude Code marker.",
      "match": {
        "type": "allOf",
        "conditions": [
          { "type": "env_set", "name": "CLAUDE_CODE_IS_COWORK" },
          {
            "type": "anyOf",
            "conditions": [
              { "type": "env_set", "name": "CLAUDECODE" },
              { "type": "env_set", "name": "CLAUDE_CODE" }
            ]
          }
        ]
      }
    },
    {
      "key": "CLAUDE",
      "name": "claude_code",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "CLAUDECODE" },
          { "type": "env_set", "name": "CLAUDE_CODE" }
        ]
      }
    },
    {
      "key": "REPLIT",
      "name": "replit",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "REPL_ID" }]
      }
    },
    {
      "key": "GITHUB_COPILOT",
      "name": "github-copilot",
      "match": {
        "type": "anyOf",
        "conditions": [
          { "type": "env_set", "name": "COPILOT_MODEL" },
          { "type": "env_set", "name": "COPILOT_ALLOW_ALL" },
          { "type": "env_set", "name": "COPILOT_GITHUB_TOKEN" }
        ]
      }
    },
    {
      "key": "KIRO",
      "name": "kiro",
      "description": "AWS Kiro. TERM_PROGRAM=kiro is set by both the IDE terminal and the CLI agent, so gate on no_tty to avoid misdetecting a human at the integrated terminal.",
      "match": {
        "type": "allOf",
        "conditions": [
          { "type": "env_matches", "name": "TERM_PROGRAM", "pattern": "kiro" },
          { "type": "no_tty" }
        ]
      }
    },
    {
      "key": "OPENCLAW",
      "name": "openclaw",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "env_set", "name": "OPENCLAW_SHELL" }]
      }
    },
    {
      "key": "DEVIN",
      "name": "devin",
      "match": {
        "type": "anyOf",
        "conditions": [{ "type": "file_exists", "path": "/opt/.devin" }]
      }
    }
  ]
}