Universal Ai Config

universal-ai-config

Generate tool-specific AI config files from shared templates. Write your AI instructions, skills, agents, hooks, and MCP server configs once — generate config for Claude Code, GitHub Copilot, Cursor, and OpenAI Codex automatically.

Table of Contents

• Why
• Install
• Quick Start
• Template Structure
• Writing Templates
  • Instructions
  • Skills
  • Agents
  • Hooks
  • MCP Servers
• Per-Target Overrides
• EJS Template Variables
• Configuration
  • Template Precedence & Shadowing
• CLI Reference
  • `uac generate`
  • `uac init`
  • `uac clean`
  • `uac seed`
  • `uac skill add`
• Output Paths
• Complete Template Reference
• Programmatic API
• Adding a New Target

Why

AI coding tools each have their own config formats stored in `.claude/`, `.github/`, `.cursor/`, `.codex/` (plus root `AGENTS.md` and `.agents/skills/` for Codex). Teams want shared AI config but each developer may use a different tool. This CLI generates target-specific config files from shared templates in `.universal-ai-config/`, so the tool-specific folders can be gitignored and each dev generates only what they need.

Install & Run

npm install -D universal-ai-config

npm exec uac 

**Non-JS projects:** Use `npx universal-ai-config` to run commands without installing, e.g. `npx universal-ai-config generate -t claude`.

Quick Start

# Scaffold template directory with meta-instructions and config
uac init

# Generate config for all targets
uac generate

# Generate for specific targets
uac generate -t