Contextai

contextai


[](https://www.contextai.run) [](https://www.npmjs.com/package/contextai) [](LICENSE) [](package.json) [](https://www.npmjs.com/package/contextai)

Universal context engineering CLI for AI coding agents. Define your project's conventions, stack, and architecture in a single `context.config.ts` file, then generate AI-readable context files for multiple tools from that single source of truth.

**Website:** [www.contextai.run](https://www.contextai.run)

Supported output targets

Target	File
OpenAI Codex / generic agents	AGENTS.md
Claude	CLAUDE.md
Cursor	.cursorrules
GitHub Copilot	.github/copilot-instructions.md
LLMs.txt	llms.txt
Kiro (AWS)	.kiro/steering/*.md
Windsurf	.windsurf/rules/*.md
Gemini CLI / Antigravity	GEMINI.md
Custom	any path via config

Quick start

npm install -g contextai

# Interactive setup — creates context.config.ts
contextai init

# Generate all enabled output files
contextai generate

Commands

Command	Description
contextai init	Interactive setup wizard
contextai generate	Generate output files from config
contextai generate --dry-run	Preview output without writing files
contextai generate --format json	Output JSON IR to stdout instead of writing files
contextai validate	Check output files are fresh and well-structured
contextai diff	Show diff between config and on-disk outputs
contextai watch	Watch config for changes and regenerate automatically

Configuration

Create a `context.config.ts` at your project roo