agents-config

This repository addresses the pain point of synchronizing configurations and skills across multiple machines and AI assistants. When developers use AI agents like Claude Code, Codex, and Gemini on different devices, they often need to manually copy skill files and adjust settings, which is tedious and error-prone. agents-config provides a symlink-based configuration management solution, enabling centralized management and instant synchronization of all skills and settings.

Usage is straightforward: simply clone the repository and run ./install.sh. The script will automatically symlink skill, setting, and rule files from the repository to each AI assistant's configuration directory. Afterward, you can modify configurations on any machine, push updates to the remote repository via ./sync.sh push, and pull updates on other machines with ./sync.sh pull. All destructive operations automatically create timestamped backups, and ./sync.sh undo allows for easy rollback.

It is ideal for developers who need to use AI assistants across devices, especially those managing multiple AI agents (e.g., Claude, Gemini, Codex) individually or in teams. For full-stack engineers and operations personnel frequently switching development environments or using multiple workstations or cloud servers, this tool significantly reduces configuration maintenance effort and ensures the skill library is always up to date.

It is recommended to run ./install.sh --dry-run on first use to preview the actions that will be taken, avoiding accidental overwrites of existing configurations. Note that it primarily relies on symlinks, so it is best used in Linux/macOS environments that support symbolic links; Windows users need WSL or Git Bash. Additionally, machine-specific configurations (e.g., settings.local.json) are not synchronized by design for security.