@bunli/plugin-ai-detect

AI agent detection plugin for Bunli CLI framework. Detects when your CLI is running inside AI coding assistants like Claude, Cursor, GitHub Copilot, and more.

Installation

bun add @bunli/plugin-ai-detect

Usage

import { createCLI } from '@bunli/core'
import { aiAgentPlugin } from '@bunli/plugin-ai-detect'

const cli = await createCLI({
  name: 'my-cli',
  version: '1.0.0',
  plugins: [
    aiAgentPlugin({
      verbose: true // Log when AI agents are detected
    })
  ]
})

// In your commands, you can access the detection results
cli.command({
  name: 'info',
  handler: async ({ context }) => {
    if (context?.store.isAIAgent) {
      console.log('Running in AI agent:', context.store.aiAgents.join(', '))
      console.log('Detected env vars:', context.store.aiAgentEnvVars.join(', '))
    }
  }
})

Options

interface AIDetectPluginOptions {
  /**
   * Additional custom AI agents to detect
   */
  customAgents?: AIAgentInfo[]
  
  /**
   * Whether to log detection results
   * Default: false
   */
  verbose?: boolean
}

interface AIAgentInfo {
  name: string
  envVars: string[]
  detect: (env: NodeJS.ProcessEnv) => boolean
}

Built-in Detections

The plugin detects the following AI agents out of the box:

• Claude: Detects Claude Code via CLAUDECODE environment variable
• Cursor: Detects Cursor via CURSOR_AGENT environment variable

Custom Agents

You can add detection for additional AI agents:

aiAgentPlugin({
  customAgents: [
    {
      name: 'github-copilot',
      envVars: ['GITHUB_COPILOT_ENABLED'],
      detect: (env) => !!env.GITHUB_COPILOT_ENABLED
    },
    {
      name: 'my-custom-ai',
      envVars: ['MY_AI_ACTIVE', 'MY_AI_VERSION'],
      detect: (env) => env.MY_AI_ACTIVE === 'true'
    }
  ]
})

Store Properties

The plugin provides the following typed properties in the command context store:

interface AIDetectStore {
  /** Whether any AI agent was detected */
  isAIAgent: boolean
  
  /** List of detected AI agent names */
  aiAgents: string[]
  
  /** Environment variables that triggered detection */
  aiAgentEnvVars: string[]
}

Environment Extensions

The plugin also extends the environment info:

// These properties are added to context.env
interface EnvironmentInfo {
  isAIAgent: boolean
  aiAgents: string[]
}

Use Cases

• Telemetry: Track which AI assistants are using your CLI
• Feature Flags: Enable special features for AI environments
• Debugging: Add extra logging when running in AI assistants
• Optimization: Adjust output formatting for AI consumption

License

MIT © Arya Labs, Inc.