Converge

Auto-sync a git repository by watching for file changes, automatically committing them, and pulling from a remote.

Converge notifies the user via libnotify / notify-send whenever a merge conflict occurs during automatic pulling.

Usage

# Watch the current directory (defaults)
./scripts/run

# Watch a specific repo
./scripts/run -- --repo /path/to/repo --branch master

# Custom debounce (10 seconds)
./scripts/run -- --debounce 10000

Options

Option	Default	Description
-r, --repo PATH	. (cwd)	Path to the git repository
-d, --debounce MS	5000	Debounce window in milliseconds
--remote NAME	origin	Remote name to pull from
-b, --branch NAME	main	Branch to pull

Development

All development tools run inside Docker via the hs wrapper script.

# Build (format + compile)
./scripts/build

# Run tests
./scripts/test

# Run the tool
./scripts/run

# Install to ~/.local/bin
./scripts/install

Design

• Language: Haskell (GHC 9.10.3 via lts-24.38)
• File watching: fsnotify
• Notifications: shell out to notify-send (libnotify)
• Daemonization: TBD (likely systemd service)