A unified configuration manager for AI coding assistants that keeps Claude Code, Codex, Gemini CLI, and OpenCode settings in sync.
Seamlessly deploy consistent instructions, commands, skills, and MCP integrations across agents through a single installer, centralizing setup and reducing maintenance.
AI tools all support configuration, but every agent uses a different format and directory layout. Keeping them in sync by hand is slow and error-prone.
This project:
- Provides one installer for multiple agents
- Keeps installation paths and updates consistent
- Makes maintenance easier by centralizing the source of truth
- Ships curated best practices, agents, skills, and commands out of the box
npx @azat-io/ai-configThe installer will:
- Ask which agents to install
- Ask for install scope (project or home)
- Ask which MCP servers to install
GitHub workflows use gh CLI rather than a bundled GitHub MCP server.
Sources live in this repo and are copied into each agent's config:
instructions/global.mdcommands/agents/skills/hooks/settings/mcp.ts(sequential-thinking, fetch)
You choose one scope for the entire run.
Creates dot-folders in the current project and places instructions in the project root:
- Claude Code
.claude/commands/,.claude/agents/,.claude/skills/,.claude/hooks/.claude/settings.json(MCP)CLAUDE.md
- Codex
.codex/agents/*.toml(multi-agent role configs).codex/skills/.codex/config.toml(MCP)AGENTS.md
- Gemini CLI
.gemini/commands/,.gemini/agents/,.gemini/skills/,.gemini/hooks/.gemini/settings.json(MCP)GEMINI.md
- OpenCode
.opencode/commands/,.opencode/agents/,.opencode/skill/opencode.json(MCP)AGENTS.md
Uses the user config directories:
- Claude Code:
~/.claude/ - Codex:
~/.codex/ - Gemini CLI:
~/.gemini/ - OpenCode:
~/.config/opencode/
- Node.js v22+
ghCLI for GitHub repositories, issues, and pull requests- Run
gh auth loginbefore GitHub-related tasks - MCP dependencies (only if you plan to use built-in MCP servers):
uv(foruvx)
| Agent | Instructions | Commands | Skills | Subagents | Hooks | MCP |
|---|---|---|---|---|---|---|
| Claude Code | Yes | Yes | Yes | Yes | Yes | Yes |
| Codex | Yes | No | Yes | Yes | No | Yes |
| Gemini CLI | Yes | Yes | Yes | Yes | Yes | Yes |
| OpenCode | Yes | Yes | Yes | Yes | No | Yes |
Codex subagents use the experimental multi-agent feature. The installer enables
[features] multi_agent = true in .codex/config.toml; restart Codex after
installation for the change to take effect.
| Command | Description |
|---|---|
/blueprint |
Create a detailed implementation blueprint before coding |
/code-review |
Review code quality before merge |
/commit |
Generate Conventional Commits message from staged changes |
/discovery |
Clarify vague ideas and align on scope |
/docs |
Write or update project documentation |
/implement |
Execute an approved implementation blueprint |
/refactor |
Refactor code while preserving behavior |
/research |
Explore technical approaches when requirements are fuzzy |
/test |
Write tests for TDD or bug fixes |
| Skill | Description |
|---|---|
blueprinting |
Write detailed implementation blueprints before coding |
creating-skills |
Create reusable techniques and patterns for AI agents |
creating-subagents |
Create specialized subagents for recurring tasks |
discovering |
Clarify goals and scope when the what/why is unclear |
implementing |
Execute an approved implementation blueprint |
refactoring |
Behavior-preserving restructuring for clarity and safer changes |
researching |
Choose technical approaches when the how is unclear |
| Agent | Description |
|---|---|
code-reviewer |
Review code for correctness, security, and maintainability |
documentation-writer |
Write README, API docs, JSDoc, and contributing guides |
explorer |
Build repository maps and collect evidence-based facts |
implementer |
Implement features following plans and specs |
test-writer |
Write focused tests with full code path coverage |
| Server | Description |
|---|---|
| Fetch | Fetch and process web pages |
| Sequential Thinking | Step-by-step reasoning for complex problems |
- @azat-io/eslint-config
- @azat-io/prettier-config
- @azat-io/stylelint-config
- @azat-io/typescript-config
MIT © Azat S.