@reliverse/rempts-plugin-ai-detect 2.3.1

package/README.md

@@ -0,0 +1,128 @@
+# rempts-plugin-ai-detect
+
+AI agent detection plugin for Rempts CLI framework. Detects when your CLI is running inside AI coding assistants like Claude, Cursor, GitHub Copilot, and more.
+
+## Installation
+
+```bash
+bun add rempts-plugin-ai-detect
+```
+
+## Usage
+
+```typescript
+import { createCLI } from '@reliverse/rempts-core'
+import { aiAgentPlugin } from '@reliverse/rempts-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
+
+```typescript
+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:
+
+```typescript
+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:
+
+```typescript
+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:
+
+```typescript
+// 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 © blefnk

package/dist/mod.d.ts

@@ -0,0 +1,30 @@
+/**
+ * AI agent detection plugin for Rempts
+ * Detects various AI coding assistants from environment variables
+ */
+interface AIAgentInfo {
+    name: string;
+    envVars: string[];
+    detect: (env: NodeJS.ProcessEnv) => boolean;
+}
+export interface AIDetectPluginOptions {
+    /**
+     * Additional custom AI agents to detect
+     */
+    customAgents?: AIAgentInfo[];
+    /**
+     * Whether to log detection results
+     * Default: false
+     */
+    verbose?: boolean;
+}
+export interface AIDetectStore {
+    isAIAgent: boolean;
+    aiAgents: string[];
+    aiAgentEnvVars: string[];
+}
+/**
+ * AI agent detection plugin factory
+ */
+export declare const aiAgentPlugin: any;
+export default aiAgentPlugin;

package/dist/mod.js

@@ -0,0 +1,71 @@
+import { createPlugin, createPluginStore } from "@reliverse/rempts-core/plugin";
+const AI_AGENTS = [
+  {
+    name: "claude",
+    envVars: ["CLAUDECODE"],
+    detect: (env) => !!env.CLAUDECODE
+  },
+  {
+    name: "cursor",
+    envVars: ["CURSOR_AGENT"],
+    detect: (env) => !!env.CURSOR_AGENT
+  }
+];
+export const aiAgentPlugin = createPlugin(
+  (options = {}) => {
+    const agents = [...AI_AGENTS, ...options.customAgents || []];
+    return () => ({
+      // Define initial store state using Zustand
+      store: createPluginStore({
+        isAIAgent: false,
+        aiAgents: [],
+        aiAgentEnvVars: []
+      }),
+      beforeCommand(context) {
+        const env = process.env;
+        const detectedAgents = [];
+        const allDetectedEnvVars = [];
+        context.env.isAIAgent = false;
+        context.env.aiAgents = [];
+        for (const agent of agents) {
+          if (agent.detect(env)) {
+            detectedAgents.push(agent.name);
+            const detectedVars = agent.envVars.filter((v) => !!env[v]);
+            allDetectedEnvVars.push(...detectedVars);
+            if (options.verbose) {
+              console.log(`\u{1F916} AI agent detected: ${agent.name}`);
+              console.log(`   Environment variables: ${detectedVars.join(", ")}`);
+            }
+          }
+        }
+        if (detectedAgents.length > 0) {
+          context.env.isAIAgent = true;
+          context.env.aiAgents = detectedAgents;
+          if (context.store) {
+            context.store.setState({
+              isAIAgent: true,
+              aiAgents: detectedAgents,
+              aiAgentEnvVars: allDetectedEnvVars
+            });
+          }
+          if (options.verbose) {
+            if (detectedAgents.length === 1) {
+              console.log(`\u{1F916} AI agent detected: ${detectedAgents[0]}`);
+            } else {
+              console.log(`\u{1F916} Multiple AI agents detected: ${detectedAgents.join(", ")}`);
+            }
+          }
+        } else {
+          if (context.store) {
+            context.store.setState({
+              isAIAgent: false,
+              aiAgents: [],
+              aiAgentEnvVars: []
+            });
+          }
+        }
+      }
+    });
+  }
+);
+export default aiAgentPlugin;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@reliverse/rempts-plugin-ai-detect",
+  "version": "2.3.1",
+  "description": "AI agent detection plugin for Rempts - detects Claude, Cursor, Copilot and other AI coding assistants",
+  "keywords": [
+    "ai",
+    "claude",
+    "cli",
+    "copilot",
+    "cursor",
+    "plugin",
+    "rempts"
+  ],
+  "license": "MIT",
+  "author": "bun dler Team",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./src/mod.ts",
+  "types": "./src/mod.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "default": "./dist/mod.js"
+    }
+  },
+  "dependencies": {
+    "@reliverse/rempts-core": "2.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/mod.ts

@@ -0,0 +1,136 @@
+/**
+ * AI agent detection plugin for Rempts
+ * Detects various AI coding assistants from environment variables
+ */
+
+import { createPlugin, createPluginStore } from "@reliverse/rempts-core/plugin";
+
+// Extend core interfaces with AI-specific fields
+// declare module "@reliverse/rempts-core/plugin" {
+//   interface EnvironmentInfo {
+//     /** AI agent detected */
+//     isAIAgent: boolean;
+
+//     /** Detected AI agents */
+//     aiAgents: string[];
+//   }
+// }
+
+interface AIAgentInfo {
+  name: string;
+  envVars: string[];
+  detect: (env: NodeJS.ProcessEnv) => boolean;
+}
+
+// Known AI agents and their detection patterns
+const AI_AGENTS: AIAgentInfo[] = [
+  {
+    name: "claude",
+    envVars: ["CLAUDECODE"],
+    detect: (env) => !!env.CLAUDECODE,
+  },
+  {
+    name: "cursor",
+    envVars: ["CURSOR_AGENT"],
+    detect: (env) => !!env.CURSOR_AGENT,
+  },
+];
+
+export interface AIDetectPluginOptions {
+  /**
+   * Additional custom AI agents to detect
+   */
+  customAgents?: AIAgentInfo[];
+
+  /**
+   * Whether to log detection results
+   * Default: false
+   */
+  verbose?: boolean;
+}
+
+export interface AIDetectStore {
+  isAIAgent: boolean;
+  aiAgents: string[];
+  aiAgentEnvVars: string[];
+}
+
+/**
+ * AI agent detection plugin factory
+ */
+export const aiAgentPlugin = createPlugin<AIDetectPluginOptions | undefined, AIDetectStore>(
+  (options: AIDetectPluginOptions = {}) => {
+    const agents = [...AI_AGENTS, ...(options.customAgents || [])];
+
+    return () => ({
+      // Define initial store state using Zustand
+      store: createPluginStore<AIDetectStore>({
+        isAIAgent: false,
+        aiAgents: [] as string[],
+        aiAgentEnvVars: [] as string[],
+      }),
+
+      beforeCommand(context) {
+        const env = process.env;
+        const detectedAgents: string[] = [];
+        const allDetectedEnvVars: string[] = [];
+
+        // Initialize AI fields on the environment info
+        (context.env as any).isAIAgent = false;
+        (context.env as any).aiAgents = [];
+
+        // Check all known AI agents
+        for (const agent of agents) {
+          if (agent.detect(env)) {
+            detectedAgents.push(agent.name);
+
+            // Store detected environment variables for this agent
+            const detectedVars = agent.envVars.filter((v) => !!env[v]);
+            allDetectedEnvVars.push(...detectedVars);
+
+            // Log if verbose
+            if (options.verbose) {
+              console.log(`🤖 AI agent detected: ${agent.name}`);
+              console.log(`   Environment variables: ${detectedVars.join(", ")}`);
+            }
+          }
+        }
+
+        // Update context based on detection results
+        if (detectedAgents.length > 0) {
+          (context.env as any).isAIAgent = true;
+          (context.env as any).aiAgents = detectedAgents;
+
+          // Use type-safe store - TypeScript knows the exact types!
+          if (context.store) {
+            context.store.setState({
+              isAIAgent: true,
+              aiAgents: detectedAgents,
+              aiAgentEnvVars: allDetectedEnvVars,
+            });
+          }
+
+          if (options.verbose) {
+            if (detectedAgents.length === 1) {
+              console.log(`🤖 AI agent detected: ${detectedAgents[0]}`);
+            } else {
+              console.log(`🤖 Multiple AI agents detected: ${detectedAgents.join(", ")}`);
+            }
+          }
+        } else {
+          // Ensure fields are initialized even when no AI agent detected
+          if (context.store) {
+            context.store.setState({
+              isAIAgent: false,
+              aiAgents: [],
+              aiAgentEnvVars: [],
+            });
+          }
+        }
+      },
+    });
+  }
+);
+
+// Default export for convenience
+export default aiAgentPlugin;