create-codex

# create-codex

AGENTS.md setup that just works. Bootstrap every project with the open standard for AI coding agents. One command, zero headaches.

[![version](https://img.shields.io/npm/v/create-codex.svg?label=version&color=brightgreen)](https://www.npmjs.com/package/create-codex)
[![downloads](https://img.shields.io/npm/dm/create-codex.svg?label=downloads&color=blue)](https://www.npmjs.com/package/create-codex)
[![package size](https://img.shields.io/npm/unpacked-size/create-codex?label=package%20size&color=yellow)](https://www.npmjs.com/package/create-codex)
[![license](https://img.shields.io/badge/license-MIT-red.svg)](https://opensource.org/licenses/MIT)

## Quick Start

```bash
npm create codex
```

*Adds **local** AGENTS.md file to your project. ZERO dependencies, ZERO overhead.*

## Installation Options

### Package Managers

```bash
npm create codex               # npm
pnpm create codex              # pnpm  
bun create codex               # bun
yarn create codex              # yarn
```

### Flags

```bash
npm create codex --dry-run     # Preview files
npm create codex --help        # All options
```

### Shortcuts

```bash
npx create-codex                # Direct execution
npx create-codex my-project     # Create in specific directory
```

## Programmatic Usage

### Installation

```bash
npm i create-codex
```

### Usage

```typescript
import { init } from 'create-codex';

await init('./my-project');
```

## Features

### Universal Compatibility

- **Works everywhere**: Codex, Cursor, Aider, Jules, Zed, Windsurf, Continue, and more
- **Open standard**: AGENTS.md is supported by 20k+ projects
- **Zero lock-in**: One file that works with any AI coding agent

### Intelligent Project Detection

- **Runtime detection**: Node.js, Python, Rust, Go, Java, C/C++, TypeScript, Bun
- **Framework detection**: React, Next.js, Vue, Angular, Svelte, Express, FastAPI
- **Package manager detection**: npm, yarn, pnpm, bun, pip, poetry, uv
- **Git integration**: Repository UR