QGIS Plugin Manager is a professional, high-performance CLI tool designed to manage the full lifecycle of QGIS plugins. From local development and smart synchronization to official repository compliance and automated versioning. Now available on PyPI for easy integration.

qgis-plugin-manager is the modern successor to traditional QGIS development workflows.

• Smart Synchronization (Sync v2.0): We use idempotent sync logic. Instead of slow "delete and copy", we only update modified files.
• Native Python Hooks Architecture: Write your automation in pure Python via plugin_hooks.py. Hooks receive full project context (metadata, paths, profiles).
• Official Repository "First-Time-Right": Built-in --repo-check and structural validation catch errors before you upload to QGIS.
• AI-Agent Friendly: Specifically designed to be easily automated by AI agents, featuring clear metadata and a modular command system.

Install system-wide using uv (recommended):

uv tool install qgis-manage

Or add as a dev-dependency:

uv add --group dev qgis-manage

Or using pip:

pip install qgis-manage

Scaffold a professional plugin project.

# Create a processing plugin
qgis-manage init "My Plugin" --author "Tester" --email "[email protected]" --template processing

Speed up your local iteration.

# Smart deploy to default QGIS profile
qgis-manage deploy

# Deploy to a specific profile with backup rotation
qgis-manage deploy --profile production --max-backups 5

# Purge old backups to save space
qgis-manage deploy --purge-backups

Manage and test your native Python hooks.

# List all hooks from pyproject.toml and plugin_hooks.py
qgis-manage hooks list

# Initialize a standard plugin_hooks.py template
qgis-manage hooks init

# Test a hook in isolation without deploying
qgis-manage hooks test pre_deploy

Keep your versions in sync across all project files.

# Increment version (Patch, Minor, Major)
qgis-manage bump patch   # 0.1.0 -> 0.1.1
qgis-manage bump minor   # 0.1.1 -> 0.2.0

# Sync metadata.txt from pyproject.toml source of truth
qgis-manage bump sync

Prepare for the Official QGIS Plugin Repository.

# Create a "Repo-Ready" ZIP package
qgis-manage package

# Package with strict compliance check (fails if binaries or errors found)
qgis-manage package --repo-check --sync-version

# Run deep structural validation
qgis-manage validate --strict --repo

# Run QGIS Plugin Analyzer on the project
qgis-manage analyze

# Clean Python artifacts (__pycache__) and build files
qgis-manage clean

Leverage YOUR existing configuration. No new files needed.

[tool.qgis-manager]
max_backups = 5  # Control backup rotation

[tool.qgis-manager.ignore]
ignore = [
    "data/*.csv",
    "tests/temp/*"
]

[tool.qgis-manager.hooks]
post_deploy = "python scripts/notify.py"

Automated compilation and management of .ts and .qm files is handled by qgis-manage compile.

GPL-2.0-or-later