• Windsurf generator — outputs .windsurf/rules/project-context.md with YAML frontmatter trigger: always_on so Cascade loads context automatically in every interaction
• Enable via '.windsurf/rules': true in outputs config
• Gemini generator — outputs GEMINI.md in project root, plain markdown without frontmatter
• Covers both Gemini CLI and Antigravity (Google); Antigravity also reads AGENTS.md which was already supported
• Enable via 'GEMINI.md': true in outputs config
• --format json flag on contextai generate — outputs JSON IR to stdout instead of writing files
• Structure: { version, generatedAt, config, outputs } — useful for CI, piping, and debugging
• Total supported targets now: CLAUDE.md, .cursorrules, AGENTS.md, .github/copilot-instructions.md, llms.txt, .kiro/steering, .windsurf/rules, GEMINI.md, and custom generators

• Kiro (AWS) steering file generator — outputs .kiro/steering/product.md, .kiro/steering/tech.md, and .kiro/steering/conventions.md from a single config
• All steering files include inclusion: always frontmatter so Kiro loads them in every interaction
• Enable via '.kiro/steering': true in outputs config
• Convention scoping respected: human-only sections excluded, agent-only and unscoped sections included

Universal context engineering CLI for AI coding agents. Define your project's conventions once in context.config.ts – generate context files for all your AI tools automatically.

What's included

Commands

• contextai init — interactive setup wizard with framework auto-detection
• contextai generate — generate all enabled output files (supports --dry-run)
• 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

Generators

• AGENTS.md — OpenAI Codex / generic agents
• CLAUDE.md — Claude
• .cursorrules — Cursor
• .github/copilot-instructions.md — GitHub Copilot
• llms.txt
• Custom generators via config

Other

• Built-in framework templates: Next.js, NestJS, Express, Remix, SvelteKit
• Convention scopes (agent-only, human-only)
• Git pre-commit hook installer
• Programmatic API
• Zod-based config validation with clear error messages

Install

npm install -g contextai