ZanRealsync-conf

Documentation

Learn how to discover, install, and sync AI agent configurations with sync-conf.

What is sync-conf?

sync-conf is a CLI tool and directory for AI coding assistant configurations. Browse community-shared rules, presets, and MCP configs for Claude Code, Cursor, Windsurf, and Aider - then install them with a single command.

Think of it as npm for AI agent configurations. The directory ranks configurations by community usage, making it easy to discover what works best.

Getting Started

Install a configuration from any GitHub repository using npx (no installation required):

npx sync-conf install owner/repo

This fetches the configuration and sets it up in your local environment. For example, to install a popular Cursor configuration:

npx sync-conf install popular-user/cursor-config

Supported AI Coding Assistants

Claude Code (Anthropic)

Syncs .claude/ directories, CLAUDE.md files, and MCP server configurations.

Cursor

Syncs .cursorrules files, .cursor/ directories, and editor settings.

Windsurf (Codeium)

Syncs Windsurf configuration files and AI assistant rules.

Aider

Syncs .aider configurations and model presets.

CLI Reference

install

Install an AI agent configuration from a GitHub repository.

npx sync-conf install <owner/repo> [options]

--force, -f - Overwrite existing configuration

--list - List available configs in repo without installing

sync (default)

Sync your local configuration with the latest from the repository. This is the default behavior when running sync-conf without arguments.

npx sync-conf

browse

Browse popular configurations from the command line.

npx sync-conf browse

doctor

Check your configuration and diagnose issues.

npx sync-conf doctor

How the Directory Rankings Work

The directory ranks repositories based on anonymous telemetry data collected when users install or sync configurations. Rankings are based on:

  • Total install count
  • Unique users
  • Recent activity (24h and 1h trending)

All data is collected anonymously - we never collect personal information, repository contents, or any sensitive data.

Privacy & Telemetry

sync-conf collects minimal, anonymous telemetry to power the directory rankings:

  • Install and sync event counts (anonymous)
  • Which agents are being used (e.g., "claude-code", "cursor")
  • Repository names for public repos (for leaderboard)

To opt out of telemetry completely:

SYNC_CONF_TELEMETRY=false npx sync-conf install owner/repo

Or set it permanently in your shell profile.

Frequently Asked Questions

How do I share my Cursor rules?

Create a GitHub repository with your .cursorrules file or cursor/ directory. Others can then install with npx sync-conf install your-username/your-repo.

Can I sync Claude Code MCP configurations?

Yes. sync-conf supports syncing .claude/ directories, including MCP server configurations, CLAUDE.md files, and all Claude Code settings.

How do I get my repo on the directory?

Your repository is automatically added when someone installs it using sync-conf. There's no registration required - just share your install command and watch your ranking grow.

Does sync-conf work offline?

The install command requires internet to fetch from GitHub. However, once installed, your configurations are stored locally and work offline. Sync operations require internet to check for updates.

Browse the Directory

Head to the configuration directory to discover popular AI agent configurations from the community.