fate-casino 0.1.0

✨💖 Don't ask, just pull! 🎰🪙

fate

Pull makes happy!

fate is a Python program that helps git pull a bunch of Git repositories in your home directory or similar. (The name comes from Fate's Thread Casino in Mystery Hunt 2026, in which the protagonists become addicted to the Keeper's gacha machines.)

Installation

It's fate-casino on PyPi, so e.g.

uv tool install fate-casino
fate --help

Usage

See the argparse help for full options.

fate init (or fate i)

For every directory you want to use with fate, you need to create a .faterc or faterc (the latter takes precedence) in the root of that Git repository. You can do this by running fate init.

This is a TOML 1.1 file that specifies which actions fate performs when run on that repository, and looks something like this:

[config]
branch = "main"
venv = ".venv" # path to the virtual environment, if using uv

[actions]
pull = {enabled = true}
uv = {enabled = true, commit = true}
prek = {enabled = true, commit = true}
push = {enabled = true, verify = true}

fate run (or fate r)

Once a directory has .faterc set up, you can use fate run. The actions supported right now, if you have a clean working state:

• pull: runs git pull if there is a configured remote and clean workdir. If the working directory is dirty but there's a remote, runs git fetch instead.
• uv: runs uv sync --upgrade in order to update uv.lock If the commit option is enabled, also git commit's the change.
• prek: runs prek auto-update in order to update prek.toml hooks If the commit option is enabled, also git commit's the change.
• push: runs git push if there is a configured remote. If the verify option is turned off, adds --no-verify.

fate multirun (or fate m)

This recursively runs fate run on every directory under the specified one which has a .faterc file. By default it runs all enabled tasks; but you can also use -o/--only or -e/--exclude to restrict the list. Note that fate will never run a task not actually enabled in .faterc.

You can throttle the run with -t/--throttle to sleep a bit between repositories.

Shortcuts for fate multirun

• fate ls (or fate l, or fate list): shows the status of each repository without running any tasks. It doesn't make any network queries, so it's the fastest.
• fate pull: equivalent to fate multirun --only pull
• fate gamble (or fate g): equivalent to fate multirun --exclude push.
• fate push: equivalent to fate multirun --only push