agents — Unified config management for multi LLM…

Pitch

Description

Comments

About this project

agents offers a single configuration point to manage MCP servers, skills, and instructions across various AI tools such as Codex, Claude, and Gemini. Simplifying onboarding and updates, this solution mitigates the hassle of maintained multiple config files while ensuring all tools are seamlessly synchronized.

The agents project offers a unified configuration management solution designed to streamline multi-LLM development. With this tool, developers can simplify their interactions with a variety of AI platforms, including Codex, Claude, Cursor, and Gemini, through a single source of truth that enhances organization and reduces complexity.

Key Features

Centralized Configuration: Utilize a single set of config files located in the .agents/ directory to manage all Multi-Channel Protocol (MCP) servers, skills, and instructions across different tools effortlessly.
Automatic Synchronization: The CLI tools automatically sync MCP servers and skills, ensuring that changes made in one place are reflected across all integrated platforms.

Project Structure

.agents/
  ├── agents.json      → All your MCP servers
  ├── local.json       → Your secrets (gitignored)
  └── skills/          → Reusable team workflows

Supported Tools

Tool	MCP Integration	Skills	Instructions
Codex	✅	✅	✅
Claude Code	✅	✅	✅
Gemini CLI	✅	✅	✅
Cursor	✅	✅	✅
Copilot	✅	⏳	✅
Antigravity	✅	✅	✅

Command Overview

Command	Description
`agents start`	Launch the interactive setup wizard.
`agents sync`	Update all tools with the latest config.
`agents mcp add <url>`	Add a new MCP server URL.
`agents mcp list`	Display all configured MCP servers.
`agents doctor`	Diagnose configuration issues.
`agents status`	Check the connection status of all tools.
`agents watch`	Enable real-time synchronization of changes.

How It Works

Edit the .agents/agents.json file or utilize the CLI for modifications.
The agents tool reads the configuration and automatically generates the specific config files needed for each integrated tool.
This allows developers to focus on coding without the burden of managing multiple configuration files.

Getting Started

Simply install the npm package, initialize the agents setup in your project directory, and run the synchronization command to keep everything up-to-date. This ensures that all configurations are consistently aligned across various platforms, minimizing the risks of errors due to outdated or mismatched configurations.

Community & Support

If issues arise or suggestions for improvements come to mind, users are encouraged to engage with the community by reporting bugs or participating in discussions to enhance the project further.

This repository is constructed to assist AI developers in navigating the complexities of multi-LLM environments efficiently, providing them with tools necessary for collaborative and successful developments.