icloud-git

Alpha: This project is in early development and may not work as expected. Use with caution.

CLI tool to host git repositories on iCloud Drive.

Creates a bare git repository in ~/Library/Mobile Documents/com~apple~CloudDocs/icloud-git-repos/ and sets it as the origin remote of your local repository.

Requirements

• macOS with iCloud Drive enabled
• Git installed

Installation

brew tap tseylerd/tap
brew install icloud-git

Usage

Initialize a new repository in the current directory:

icloud-git init

Optionally specify a repository name (defaults to the current directory name):

icloud-git init my-repo

Then push as usual:

git push origin main

Warning

If Optimize Mac Storage is enabled in iCloud settings, iCloud may offload repository files to the cloud and replace them with placeholders. This may cause git operations to fail.

It is recommended to keep Optimize Mac Storage turned off, or manually re-download the repos folder when needed: