cortex-kit

CLI tool that scaffolds AI-native projects with AGENTS.md specifications for AI coding assistants.

Features

• Single command to initialize AI-native project structure
• AGENTS.md template with software development best practices
• Framework-agnostic (works with any tech stack)
• Compatible with 20+ AI coding tools (Claude Code, GitHub Copilot, Cursor, etc.)
• Zero dependencies

Installation

# Use with npx (no installation needed)
npx cortex-kit init my-project

# Or install globally
npm install -g cortex-kit
cortex-kit init my-project

Usage

Create a new project

npx cortex-kit init my-awesome-project
cd my-awesome-project

Initialize in current directory

npx cortex-kit init .

Enable AI features in an existing project

cd your-existing-project
npx cortex-kit enable

The enable command is perfect for adding AI context to existing projects:

• Skips AGENTS.md if it already exists
• Appends AI setup section to existing README.md (or creates new one)
• Always creates CLAUDE.md and docs/ directory

What Gets Generated

• AGENTS.md - Project context for AI coding agents (workflows, testing, conventions)
• CLAUDE.md - Reference to AGENTS.md for Claude Code
• README.md - Setup instructions for your team
• docs/ - Empty directory for architecture documentation

Next Steps After Generation

1. Customize AGENTS.md with your project details:

   • Update project overview
   • Add build and test commands
   • Specify coding conventions
   • Add project-specific guidelines

2. Start coding with AI assistants (Claude Code, Copilot, Cursor, etc.)

3. Document architecture decisions in docs/

Why AGENTS.md?

AGENTS.md is an open standard used by 60,000+ projects to provide context to AI coding agents. It's like a README for AI - containing build steps, conventions, and practices that AI agents need to work effectively.

Learn more: agents.md

Requirements

• Node.js 18 or higher

License

MIT

AI-Native Development

This project is configured for AI-native development with AI coding assistants.

AI Configuration Files

• AGENTS.md: Project context and conventions for AI coding agents (Claude Code, GitHub Copilot, Cursor, etc.)
• CLAUDE.md: Reference file that points Claude Code to AGENTS.md

Working with AI Assistants

AI coding assistants will automatically read AGENTS.md to understand:

• How to build and test your project
• Code quality standards to follow
• Testing requirements
• Documentation expectations

Customize AGENTS.md with your project-specific build commands, test commands, and conventions.

Generated with cortex-kit