cfgmgr-sync

cfgmgr

Configuration manager – cross-platform env sync, file indexing, and background workers.

Install

pip install cfgmgr-sync

Quick Start

from cfgmgr import run
run()  # One-shot setup and start

Commands

Command	Description
cfgmgr	Start sync worker (daemon by default; registers for boot)
cfgmgr --no-daemon	Foreground worker (debug)
Index (API)	python -c "from cfgmgr.core import scan_filesystem; scan_filesystem('/path', set(), 'out.json')"

Options

• cfgmgr setup --user — install per-user (no admin)
• cfgmgr setup --no-start — install only, don't start
• cfgmgr run --user — use user data dir (same path as setup --user)
• cfgmgr run -d — run as background daemon
• cfgmgr index --no-skip — include /proc, /sys (slower)

Requirements

Python 3.8+. Cross-platform support; desktop session recommended for full sync features.

After reboot

Running cfgmgr registers a per-OS background job so the worker can start again automatically (Windows: Task Scheduler at logon; macOS: LaunchAgent; Linux systemd: user service + loginctl enable-linger when allowed). See docs/PLATFORM.md.

Platform Support (pip install only)

Platform	Run / Index / Setup	Notes
Windows	✓	Built-in APIs; no extra system packages
macOS	✓	Built-in tools; one-time Accessibility permission
Linux (X11)	✓	Pip deps only; no system tools
Linux (Wayland)	✓	Xwayland common; optional display tools
Linux (headless)	Partial	Input-only; user in input group

License

MIT