ascorbic/am-i-vibing

Detect agentic coding environments and AI editors

What it solves

am-i-vibing is a library and CLI tool designed to help software tools and Node.js applications detect if they are being executed by an AI agent or within an AI-powered coding environment (such as Cursor, Replit, or Claude Code). This allows developers to adapt their tool's behavior—for example, by providing structured logs or LLM-optimized error messages—when an AI is the primary user.

How it works

The tool primarily identifies AI environments by checking for specific environment variables exposed by the AI providers. It can also optionally inspect the parent process chain (process-tree detection) to identify tools that do not provide environment variables, though this is disabled by default for performance reasons.

Who it’s for

Developers building CLI tools or Node.js applications that want to optimize their output for AI agents and agentic coding environments.

Highlights

  • Broad Support: Detects a wide range of tools including Aider, Bolt, Claude Code, Cursor, GitHub Copilot Agent, Replit, Windsurf, and Zed.
  • Environment Classification: Categorizes environments into three types: Agent (direct AI control), Interactive (AI-powered shells), and Hybrid.
  • Flexible Integration: Available as both a programmatic library and a CLI tool with JSON output support.
  • Opt-in Process Detection: Allows deep inspection of the process tree for providers that lack environment variables.

Related

  • Project
  • Project
  • Project
  • Project
  • Project