Converge looks for its config file at $XDG_CONFIG_HOME/converge/config.yaml (typically ~/.config/converge/config.yaml). If found, it uses that file automatically.

# Run with the default XDG config file
./scripts/run

You can also specify a config file explicitly:

./scripts/run -- --config /path/to/converge.yaml

Single repository (no config file)

If no config file exists, converge falls back to watching a single repository:

# Watch the current directory
./scripts/run

# Watch a specific repo with options
./scripts/run -- --repo /path/to/repo --branch master --debounce 10000

Options

Option	Default	Description
`-c`, `--config FILE`	`$XDG_CONFIG_HOME/converge/config.yaml`	Path to YAML config file listing repositories
`-r`, `--repo PATH`	`.` (cwd)	Path to a single git repository (single-repo fallback mode)
`-d`, `--debounce MS`	`5000`	Debounce window in milliseconds (overrides config file)
`--remote NAME`	`origin`	Remote name (single-repo fallback mode)
`-b`, `--branch NAME`	`main`	Branch to pull (single-repo fallback mode)

Config file format

# ~/.config/converge/config.yaml  (XDG default)
repos:
  - path: /absolute/or/relative/path
    remote: origin    # optional, defaults to "origin"
    branch: main      # optional, defaults to "main"
  - path: /another/repo

debounce_ms: 5000     # optional, defaults to 5000

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
Concurrency: one watcher thread per repository via async
Notifications: shell out to notify-send (libnotify)
Configuration: YAML config file at XDG config path for multi-repo, CLI flags for single-repo fallback
Daemonization: TBD (likely systemd service)