unifai

Universal AI IDE Configuration & Sync Tool

A powerful CLI tool to unify your AI coding agent experience. Standardize instructions, manage MCP servers, skills, and synchronize rules across Claude Code, Antigravity, Cursor, OpenCode, and GitHub Copilot.

🚀 Key Features

• 🔄 Universal Sync & Migration - Synchronize and migrate agent instructions, rules, and MCP configs across all IDEs at once.
• 🛠️ MCP Management - Add, list, and sync Model Context Protocol servers (Standard Stdio & HTTP/SSE).
• 📁 Skills Management - Manage skills centrally (e.g., ~/.gemini/skills) or per project (e.g., .agent/skills).
• 🤖 Standardized Agents - Project-level AGENTS.md and CLAUDE.md with professional prompt templates.
• 📐 Cross-IDE Scavenging - Automatically discover rules from .claude/, .cursor/, or .agent/ and unify them.
• 🌐 Global & Workspace Rules - Manage rules centrally (e.g., ~/.gemini/GEMINI.md) or per project.

🛠️ Installation

# Install globally
npm install -g unifai

# Or use with npx
npx unifai <command>

📋 Quick Start

1. Unified Configuration & Migration

Moving from Claude Code to Antigravity? Or Cursor to Claude? Just sync. The tool will scavenge rules, instructions, and tools from all supported IDE paths and unify them across your system.

# Automatically detects .claude, .cursor, and .agent configs and applies them to all detected IDEs
unifai sync

2. Manage MCP Servers

Add local or remote tools (via HTTP/SSE) to all your AI assistants:

# Choose between Command (stdio) or HTTP server
unifai mcp add

# Sync your MCP setup to all IDE settings (settings.json, etc.)
unifai mcp sync

3. Agent Instructions

Initialize a standardized instruction set for your project with built-in best practices:

# Creates AGENTS.md, CLAUDE.md, etc.
unifai agent init

🔄 Universal Migration Paths

The sync command "scavenges" configurations from these locations and migrates them to your active IDEs:

| Feature | Discovery Paths | |---------|-----------------| | Instructions | AGENTS.md, CLAUDE.md, .github/copilot-instructions.md | | Rules | .agent/rules/, .claude/rules/, .cursor/rules/, .gemini/rules/, .cursorrules | | MCP | .mcp/mcp.json, .claude/mcp.json, .cursor/mcp.json | | Skills | skills/, .agent/skills/, .claude/skills/, .cursor/skills/, .github/skills/ |

🤖 Supported Adapters

| Adapter | Workspace File | Global File | MCP Config | Skills | |---------|----------------|-------------|------------|--------| | Antigravity | AGENTS.md | ~/.gemini/GEMINI.md | .gemini/settings.json | .agent/skills | | Claude Code | CLAUDE.md | ~/.claude.md | .claude/mcp.json | .claude/skills | | OpenCode | AGENTS.md | ~/.opencode.md | mcp.json | .opencode/skill | | Cursor | AGENTS.md | ~/.cursorrules | .cursor/mcp.json | .cursor/skills | | GitHub Copilot | .github/copilot-instructions.md | - | - | .github/skills |

🕹️ Command Reference

| Command | Description | |---------|-------------| | sync | Sync & Migrate all configs across all detected IDEs | | mcp add | Add a new MCP server (Stdio or HTTP) | | mcp sync | Sync MCP servers to all assistant configs | | agent init | Initialize standardized agent instruction files | | agent show | Show current agent configuration |

🏗️ Folder Structure

Universal AI IDEs follow these conventions through unifai:

• Workspace Rules: .agent/rules/ (Unified Markdown files)
• Global Config: ~/.gemini/ (Settings, global rules, and instructions)

📄 License

MIT © Agent Skills Community

🔗 Links

• GitHub Repository
• npm Package