AI Agent Config Management

Complete guide for the

ai-agent-config

CLI tool - universal skill management across AI coding platforms.

Core Commands

GitHub Sync

# Initialize with repository
ai-agent init --repo https://github.com/username/my-skills.git

# Push local skills to GitHub
ai-agent push --message "Added new skills"

# Pull skills from GitHub
ai-agent pull

# Bi-directional sync
ai-agent sync --message "Sync latest"

Installation

# Install to all detected platforms
ai-agent install

# Force reinstall
ai-agent install --force

# Install specific skill
ai-agent install --skill backend-patterns

Source Management

# Add custom source
ai-agent source add https://github.com/company/skills.git \
  --name company-skills \
  --branch main

# List sources
ai-agent source list

# Enable/disable
ai-agent source enable company-skills
ai-agent source disable company-skills

Configuration

# Get/set config values
ai-agent config get repository.url
ai-agent config set repository.autoSync true

# Edit in $EDITOR
ai-agent config edit

# Validate config
ai-agent config validate

Platform Info

# Show detected platforms
ai-agent platforms

# List installed skills
ai-agent list

Common Workflows

First-Time Setup

User: "Set up ai-agent-config with my GitHub"

Assistant:

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

# This will:
# 1. Create ~/.ai-agent/config.json
# 2. Clone your repo to ~/.ai-agent/sync-repo
# 3. Enable auto-sync (pull before push)

# Push current skills
ai-agent push --message "Initial setup"

Daily Workflow

User: "Update all my skills"

Assistant:

# Pull latest from GitHub (auto-installs)
ai-agent pull

Adding Custom Skills

User: "Add skills from my company repo"

Assistant:

# Add custom source
ai-agent source add https://github.com/company/ai-skills.git \
  --name company-skills \
  --branch main

# Update from new source (auto-installs)
ai-agent update --source company-skills

Team Sharing

User: "Share my skills with team"

Assistant:

# Push to GitHub
ai-agent push --message "Added debugging skills"

# Team members pull (auto-installs)
ai-agent pull

Architecture

File Locations

• Config:

  ~/.ai-agent/config.json

• Sync Repo:

  ~/.ai-agent/sync-repo/

  (local clone)
• Cache:

  ~/.ai-agent-config-cache/

  (external sources)

Platform Paths

• Claude Code:

  ~/.claude/skills/

• Antigravity:

  ~/.gemini/antigravity/skills/

• Cursor:

  ~/.cursor/skills/

• Windsurf:

  ~/.windsurf/skills/

• Codex:

  ~/.codex/skills/

Configuration

Key config settings:

{
  "repository": {
    "url": "https://github.com/username/skills.git",
    "branch": "main",
    "autoSync": true
  },
  "sources": {
    "official": [...],
    "custom": [...]
  }
}

Examples

Setup for Team

# Create shared repository
ai-agent init --repo https://github.com/team/shared-skills.git

# Add company skills
ai-agent source add https://github.com/company/official-skills.git \
  --name company

# Push setup
ai-agent push --message "Team setup complete"

Migration

# Initialize ai-agent-config
ai-agent init --repo https://github.com/username/skills.git

# Install to all platforms
ai-agent install --force

# Push existing skills
ai-agent push --message "Migrated to ai-agent-config"

Troubleshooting

Skills Not Installing

# Force reinstall
ai-agent install --force

# Check platforms detected
ai-agent platforms

GitHub Sync Conflicts

Auto-sync handles most conflicts automatically. If issues persist:

cd ~/.ai-agent/sync-repo
git status

Config Issues

# Validate
ai-agent config validate

# Reset if corrupted
ai-agent config reset

Tips

• Auto-Sync: Keep enabled to prevent conflicts
• Regular Pulls: Pull frequently for latest skills
• Descriptive Messages: Use

  --message

  for clear commit messages
• Force Reinstall: Use

  --force

  when skills aren't updating