Skip to content

Installation

DevSync requires Python 3.10+ and Git.

Install from PyPI

$ pip install devsync

Verify the installation:

$ devsync version
DevSync version 2.0.0

Tip

Use a virtual environment or pipx to avoid dependency conflicts:

$ pipx install devsync

Requirements

  • Python 3.10+ (3.10, 3.11, 3.12, 3.13 are tested)
  • Git (for cloning instruction repositories)
  • One or more AI coding tools (see IDE Integrations)

Configure LLM Provider

DevSync v2 uses an LLM to intelligently adapt practices to each IDE. Configure your provider once after installation:

$ devsync setup

This prompts for your LLM provider (Anthropic, OpenAI, or OpenRouter) and API key, stored in ~/.devsync/config.yaml. Without a configured provider, DevSync falls back to file-copy mode.

Check Detected IDEs

After installing, verify which AI tools DevSync detects on your system:

$ devsync tools

This scans for installed tools and shows their configuration paths. DevSync supports 23+ AI coding assistants -- see the full list.

Upgrading

$ pip install --upgrade devsync

Development Install

To contribute or modify DevSync:

$ git clone https://github.com/troylar/devsync.git
$ cd devsync
$ pip install -e .[dev]

This installs DevSync in editable mode with development dependencies (pytest, black, ruff, mypy).

See Contributing for the full development setup.

Next Steps