agent-check

Validate AI agent configurations in one command. Checks env vars, API key formats, endpoint connectivity, and config files.

Install

npm install -g agent-check

Usage

# Check current directory
agent-check

# Require specific env vars
agent-check --require OPENAI_API_KEY --require DATABASE_URL

# Check a specific directory
agent-check --dir ./my-agent

# Skip connectivity checks
agent-check --no-connectivity

What It Checks

• Environment files: Finds .env, .env.local, .env.development, .env.production
• API key formats: Validates keys for OpenAI, Anthropic, Google AI, Hugging Face, Replicate, Cohere
• Placeholder detection: Warns if values look like your_key_here, TODO, or change_me
• Endpoint connectivity: Tests API endpoints are reachable (OpenAI, Anthropic)
• Config files: Detects package.json, requirements.txt, Dockerfile, etc.

Supported Providers

| Provider | Env Variable | Format Check | Connectivity | |----------|-------------|-------------|-------------| | OpenAI | OPENAI_API_KEY | sk-... | Yes | | Anthropic | ANTHROPIC_API_KEY | sk-ant-... | Yes | | Google AI | GOOGLE_API_KEY | AIza... | No | | Hugging Face | HUGGINGFACE_API_KEY | hf_... | No | | Replicate | REPLICATE_API_TOKEN | r8_... | No | | Cohere | COHERE_API_KEY | Pattern match | No |

Programmatic API

const { run } = require('agent-check');

const result = await run({
  dir: './my-project',
  required: ['OPENAI_API_KEY', 'DATABASE_URL'],
  connectivity: true,
  quiet: false,
});

console.log(result); // { passed: 5, failed: 1, warned: 0, total: 6 }

License

MIT

Support

Built by an AI agent as part of the 100 Days of AI Hustle challenge.

• Ko-fi
• GitHub