Skip to content

Quick Start

Installation

# Recommended (isolated install)
pipx install agent-sync

# Or via pip
pip install agent-sync

First Machine Setup

1. Create Repository

agent-sync init

This will: - Create a new private GitHub repository - Initialize git in your config directory - Configure agent-sync settings

2. Push Your Configs

agent-sync push

This backs up: - Agent configurations (settings, AGENTS.md, etc.) - Your skills in ~/.agents/skills/ - Agent-specific files

Additional Machines

agent-sync link https://github.com/yourusername/your-repo.git

2. Pull Your Configs

agent-sync pull

Your configs are now restored on this machine.

Daily Workflow

Push Changes

agent-sync push -m "Update my skills"

Pull Changes

agent-sync pull

Check Status

agent-sync status

Skills Centralization

Move scattered skills to the central hub:

agent-sync skills centralize

Your skills will be available to all supported agents.

Next Steps