detect-agent

Detect AI agent tools (Cursor, Claude Code, Gemini CLI, Codex, Windsurf, GitHub Copilot, OpenCode, Qoder) and report their installation status and version.

Installation

npm install -g detect-agent

CLI Usage

# Detect all supported tools
detect-agent

# Detect a specific tool
detect-agent cursor

# Detect multiple tools
detect-agent cursor gemini

# Output as JSON
detect-agent --json
detect-agent cursor --json

# Show help
detect-agent --help

# Show version
detect-agent --version

CLI Output Example

cursor      : installed (v0.47.0) - /usr/local/bin/cursor
claude-code : not installed
gemini      : installed (v0.1.0) - /usr/local/bin/gemini
codex       : not installed
windsurf    : installed (v1.0.0) - ~/.codeium/windsurf/bin/windsurf
copilot     : installed (v1.2.3) - /usr/local/bin/copilot
opencode    : not installed
qoder       : not installed

JSON Output Example

[
  {
    "name": "cursor",
    "installed": true,
    "version": "0.47.0",
    "path": "/usr/local/bin/cursor"
  },
  {
    "name": "claude-code",
    "installed": false
  }
]

API Usage

import { detect, detectMultiple, detectAll, isValidTool } from 'detect-agent';

// Detect a single tool
const result = detect('cursor');
console.log(result);
// { name: 'cursor', installed: true, version: '0.47.0', path: '/usr/local/bin/cursor' }

// Detect multiple tools
const results = detectMultiple(['cursor', 'gemini']);
console.log(results);

// Detect all supported tools
const allResults = detectAll();
console.log(allResults);

// Check if a tool name is valid
if (isValidTool('cursor')) {
  const result = detect('cursor');
}

Supported Tools

Tool	CLI Name	Description
Cursor	cursor	Cursor IDE CLI
Claude Code	claude-code	Anthropic Claude Code CLI
Gemini CLI	gemini	Google Gemini CLI
Codex	codex	OpenAI Codex CLI
Windsurf	windsurf	Codeium Windsurf IDE CLI
GitHub Copilot	copilot	GitHub Copilot CLI
OpenCode	opencode	OpenCode CLI
Qoder	qoder	Qoder CLI

Types

interface Result {
  name: string;        // Tool name ('cursor', 'claude-code', etc.)
  installed: boolean;  // Whether the tool is installed
  version?: string;    // Version string if installed
  path?: string;       // Path to executable if installed
}

type ToolName = 'cursor' | 'claude-code' | 'gemini' | 'codex' | 'windsurf' | 'copilot' | 'opencode' | 'qoder';

const SUPPORTED_TOOLS: ToolName[] = ['cursor', 'claude-code', 'gemini', 'codex', 'windsurf', 'copilot', 'opencode', 'qoder'];

class DetectAgentError extends Error {
  tool: string;
  cause: Error;
}

Error Handling

• "Not installed" is NOT an error - returns { installed: false }
• Invalid tool names throw DetectAgentError
• Unexpected errors (subprocess crash, permission issues) are caught and return { installed: false }

Requirements

• Node.js 20.x or higher
• Cross-platform (Linux, macOS, Windows)

License

MIT