# AIReady

> Free CLI tools to optimize codebases for AI collaboration & Agentic Readiness

AIReady analyzes your codebase to identify issues that make it harder for AI models (ChatGPT, Claude, Copilot, Cursor, Windsurf) to understand and work with your code effectively. It optimizes context window usage, reduces hallucinations, and improves agentic navigation.

## Links

- Home: https://getaiready.dev
- Documentation: https://getaiready.dev/docs
- Blog: https://getaiready.dev/blog
- Full details: https://getaiready.dev/llms-full.txt
- Badge: `[![AI-Ready](https://img.shields.io/badge/AI--Ready-optimized-brightgreen)](https://getaiready.dev)`

## Core Tools (Agentic Optimization)

- @aiready/pattern-detect: Identifies semantic duplicates that waste AI context tokens and cause "context drowning".
- @aiready/context-analyzer: Calculates context window usage, dependency fragmentation, and cognitive load for LLMs.
- @aiready/consistency: Detects naming and pattern inconsistencies that confuse AI models and lead to hallucinated APIs.
- @aiready/mcp-server: Model Context Protocol server for native integration with Claude Desktop, Cursor, and Windsurf.

## Quick Start for Agents

```bash
# Run all tools at once
npx @aiready/cli scan .

# Or install globally
npm install -g @aiready/cli
aiready scan .
```

## Key Features

- 100% free and open source (MIT license)
- Runs completely offline (zero network calls)
- AI Readiness Score (0-100) for tracking progress
- Language support: TypeScript, JavaScript, Python, Java, Go, C# (95% market coverage)

## Use Cases

1. Before AI pair programming - optimize codebase first
2. Code reviews - maintain AI-friendly patterns
3. Legacy code modernization - identify refactoring areas
4. CI/CD integration - enforce AI readiness standards

## Support

- GitHub: https://github.com/getaiready/aiready-cli
- Issues: https://github.com/getaiready/aiready-cli/issues
- npm: https://www.npmjs.com/package/@aiready/cli