create-codex

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

Quick Start

npm create codex

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

Installation Options

Package Managers

npm create codex               # npm
pnpm create codex              # pnpm  
bun create codex               # bun
yarn create codex              # yarn

Flags

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

Shortcuts

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

Programmatic Usage

Installation

npm i create-codex

Usage

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 URL, branch information, user details

Production-Ready

• Atomic operations: SHA256 verification and safe file writes
• Automatic backups: Timestamped backups of existing files
• Template rendering: Smart conditionals and variable substitution

Smart AGENTS.md Generation

• Setup commands: Install, dev, build, test commands for your stack
• Code standards: Language-specific best practices and conventions
• Development workflow: Optimized step-by-step process
• Safety boundaries: Security constraints and operational limits
• Project context: Path, Git info, and environment details

FAQ

Yes. It only creates an AGENTS.md file, never modifies your code. Each file operation uses SHA256 checksums and creates timestamped backups.

# If something goes wrong, backups are here:
ls .create-codex-backup-*

Delete the AGENTS.md file:

rm AGENTS.md

Your original code stays untouched.

• Node.js 20+
• Any AI coding agent that supports AGENTS.md

That's it. No global installs, no dependencies.

It auto-detects:

• Package managers: npm, yarn, pnpm, bun, pip, poetry, uv
• Languages: JavaScript, TypeScript, Python, Go, Rust, Java, C/C++
• Frameworks: React, Vue, Next.js, Express, FastAPI, etc.

Can't find your tool? It falls back to sensible defaults.

Creates 1 file:

AGENTS.md                   # Project-specific instructions for AI agents

Future versions may support additional configuration in .codex/ directory.

Security

This project follows security best practices:

• All dependencies are audited and kept up-to-date
• Code is scanned with CodeQL and other security tools
• OpenSSF Scorecard certified
• Signed releases with build provenance

Report security issues: SECURITY.md

Contributing

Contributions welcome! Please read SECURITY.md first, then:

1. Fork the repo
2. Create a feature branch
3. Run npm run validate before committing
4. Submit a pull request

Links

Issues • Changelog • AGENTS.md Docs • Security

License

MIT © RMNCLDYO