Getting started

This guide takes you from a fresh install to live, multi-device sync.

Install the app

Download cnfgr for your platform and install it like any other desktop app:

macOS — .dmg
Windows — .exe installer
Linux — AppImage or .deb

cnfgr installs a small background daemon that auto-launches at login and lives in your menu bar / system tray. Click the tray icon to open the main window.

Create an account or sign in with email, Google, or GitHub. Your configuration is tied to your account, so signing in on a second device is all it takes to bring your setup with you.

Connect your tools

On first run, cnfgr scans for supported AI coding tools already installed on the machine and offers to import their existing configuration. You can review what it found before anything is imported or written.

See Supported tools for exactly which files cnfgr reads and writes for each tool.

Edit once, sync everywhere

Create or edit an agent, skill, command, MCP server, or context file in cnfgr. The daemon writes it into the right place for every connected tool and syncs the change to your account. Within a few seconds it lands on your other devices too.

Syncing a second device

Install cnfgr on the second machine.
Sign in to the same account.
Your agents, skills, commands, MCP servers, and context files appear and are written into that machine’s tools automatically.

Each device keeps its own mapping of where projects live on disk, so a project checked out at different paths on your laptop and desktop still resolves to the same cnfgr project. See Projects & identity.

What syncs and what doesn’t

cnfgr syncs your configuration, not your secrets.

✅ Agents, skills, slash commands, MCP server definitions, context files, per-tool settings, project mappings.
❌ .env files, API keys, OAuth tokens, or any authentication state. Secrets referenced by your config are replaced with placeholders before sync and re-hydrated only on your own devices. See Secrets & privacy.