ai-agent-config

Universal skill & workflow manager for AI coding assistants with bi-directional GitHub sync

Install

npm install -g ai-agent-config

Quick Start

# Initialize with your GitHub repo
ai-agent init --repo https://github.com/youruser/my-ai-skills.git

# Pull skills and auto-install to platforms
ai-agent pull

# Add external skill sources
ai-agent source add https://github.com/vercel-labs/agent-skills.git \
  --name vercel-labs --path skills

# Sync external skills (pull -> sync -> push)
ai-agent update

Commands

| Command | Description | |---------|-------------| | init --repo <url> | Initialize config and clone repo | | push [--message "msg"] | Git push to your skills repo | | pull | Git pull from repo + auto-install | | update | Pull → sync external skills → push | | install | Copy skills to platform directories | | list | List installed skills | | platforms | Show detected platforms | | uninstall | Remove installed skills | | source add <url> | Add custom skill source | | source remove <name> | Remove skill source | | source list | List all sources | | source enable <name> | Enable a source | | source disable <name> | Disable a source | | source info <name> | View source details | | config get <key> | Get config value | | config set <key> <value> | Set config value | | config edit | Open config in $EDITOR | | config validate | Validate configuration | | config export [file] | Export configuration | | config import [file] | Import configuration | | config reset --yes | Reset to defaults | | secrets sync | Sync MCP secrets from Bitwarden vault | | sync-external | Alias for update | | list-external | List available external skills | | version | Show version | | help | Show help |

Supported Platforms

| Platform | Skills Path | MCP Support | Format | |----------|-------------|-------------|--------| | Claude Code | ~/.claude/skills/ | ✅ claude_desktop_config.json | JSON | | Antigravity IDE | ~/.gemini/antigravity/skills/ | ✅ mcp_config.json | JSON | | Cursor | ~/.cursor/skills/ | ✅ ~/.cursor/mcp.json | JSON | | Windsurf | ~/.windsurf/skills/ | ✅ ~/.codeium/windsurf/mcp_config.json | JSON | | Codex CLI | ~/.codex/skills/ | ✅ ~/.codex/config.toml | TOML | | GitHub Copilot | ~/.github/copilot-instructions.md | ❌ | - |

New in v2.8.0: MCP server support for Cursor, Windsurf, and Codex CLI!

Secret Management

Securely sync MCP secrets from Bitwarden vault to your shell profile:

ai-agent secrets sync

How it works:

• Discovers required secrets from MCP config files (e.g., ${GITHUB_TOKEN})
• Fetches secrets from Bitwarden vault folder "MCP Secrets"
• Writes to ~/.zshrc for persistence across sessions
• Never stores Bitwarden master password

Setup: See Bitwarden MCP Setup Guide

Auto-configuration: Package automatically configures Bitwarden MCP server in Antigravity on install

Configuration

User config at ~/.ai-agent/config.json:

{
  "version": "2.5",
  "repository": {
    "url": "https://github.com/youruser/my-ai-skills.git",
    "branch": "main",
    "local": "/Users/you/.ai-agent/sync-repo"
  },
  "sources": [
    {
      "name": "vercel-labs",
      "url": "https://github.com/vercel-labs/agent-skills.git",
      "enabled": true
    }
  ],
  "lastSync": "2026-02-13T12:00:00.000Z"
}

License

MIT