ai-agent-detect 0.0.1

package/README.md

@@ -0,0 +1,22 @@
+# ai-agent-detect
+
+Detect which AI agent is running your code — structured identity and capabilities.
+
+**Status: name claimed, v0 in development.** This package does not do anything useful yet.
+
+## What it will be
+
+Runtime identification for the agentic era — `isatty()` had fifty years; agents are the third consumer class:
+
+- **Structured identity**: `{ name, version, mode, source, confidence }` — parsed, not a raw string. Reads the `AI_AGENT` environment variable standard, the `AGENT` convention (Goose, Amp), and vendor tells (`CLAUDECODE=1`, …).
+- **Signals beyond env vars**: parent-process-tree walking (detect the agent ancestor even with a stripped environment), TTY state (interactive vs headless).
+- **Capability detection**: not just *which* agent, but what it honors — which context files it reads, which skill directories it discovers.
+- **Adaptive-output helpers**: `isAgent()` as the new `isatty()` — emit agent-optimized output when your consumer is an agent.
+
+## Relationship to `detect-agent`
+
+[`detect-agent`](https://www.npmjs.com/package/detect-agent) (Vercel) answers the boolean question — *is* this an agent environment, and its name — via declarative rules. This package aims one level up: structured identity, richer signals than env/file existence checks can express, and capabilities. It will consume the `agents.json` definitions as a compatibility tier.
+
+## Alias
+
+`agent-detect` is held as an alias of this package.

package/index.js

@@ -0,0 +1,6 @@
+// ai-agent-detect 0.0.1 — name claimed, v0 in development.
+export function detect() {
+  throw new Error(
+    'ai-agent-detect v0 is in development — this 0.0.1 release only claims the name.'
+  );
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "ai-agent-detect",
+  "version": "0.0.1",
+  "description": "Detect which AI agent is running your code — structured identity (name, version, mode) and capabilities. Reads the AI_AGENT standard and the signals it misses.",
+  "license": "MIT",
+  "author": "George Mihailov",
+  "type": "module",
+  "main": "index.js",
+  "keywords": [
+    "ai-agent",
+    "AI_AGENT",
+    "agent-detection",
+    "detection",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "amp",
+    "isagent",
+    "agentic"
+  ]
+}