Skip to content

Home

Jump to bottom
Devin edited this page Oct 5, 2026 · 3 revisions

Universal AI Configuration

A unified configuration system for AI agents across multiple providers (Devin, Windsurf, Claude, and more). One source of truth for AI agent settings, skills, MCP servers, and rules.

Features

  • Unified configuration: a single config file that all AI providers read
  • XDG-compliant: follows Linux, macOS, and Windows directory standards
  • Migration support: automatically migrates existing provider configs
  • Two-way sync: ai-config sync writes the unified config back to each provider's native files (MCP servers, rules, skills, settings)
  • Wide provider coverage: Devin, Windsurf, Claude, Cursor, Codex, Gemini, VS Code/Copilot, Zed, Continue
  • Project-local config: per-project settings with a .ai/ directory
  • Shared resources: MCP servers and skills shared across providers
  • Provider overrides: provider-specific settings when you need them

Quick links

Page What it covers
Installation Install via uv, pipx, pip, binaries, or the curl installer
Quick Start Get running in a few commands
CLI Reference Every ai-config command and flag
Configuration Directory layout, config format, and precedence
Migration Move existing Devin/Windsurf/Claude configs over
Provider Integration Integrate a new AI provider
Deployment and Release How releases, PyPI, and binaries are published
Troubleshooting Common issues and fixes

Install in 30 seconds

# uv (or run without installing: uvx ai-config --help)
uv tool install universal-ai-config

# pipx
pipx install universal-ai-config

# pip
pip install universal-ai-config

# or the one-line installer
curl -fsSL https://raw.githubusercontent.com/DevArtsLab/tool-universal-ai-config/main/install.sh | bash

Then:

ai-config init        # new users
ai-config migrate     # existing users
ai-config validate    # verify the setup

Repository

DevArtsLab/tool-universal-ai-config | MIT License | pip install universal-ai-config

universal-ai-config

Getting started

Using it

For integrators

For maintainers

Repository | Issues | PyPI

Clone this wiki locally