feat: add init command, bats test suite, and CI test job

Author: jgorostegui-veridas

.github/workflows/ci.yml

@@ -16,3 +16,12 @@ jobs:
         with:
           scandir: '.'
           severity: warning
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install bats
+        run: sudo apt-get install -y bats
+      - name: Run tests
+        run: bats tests/

README.md

@@ -77,6 +77,21 @@ This:
 - Stores `.git` in `~/.git-dirs/GoogleDrive/dev/repo/`
 - Creates `.git-remote` with the URL (for other machines)
 
+### Init a new repo in cloud folder
+
+```bash
+cd ~/GoogleDrive/dev/new-project
+git-cloud init
+```
+
+Or with a path:
+
+```bash
+git-cloud init ~/GoogleDrive/dev/new-project
+```
+
+This creates a new git repo with `.git` stored locally (no `git init` + `migrate` needed).
+
 ### Setup on another machine (after cloud sync)
 
 Files arrive via cloud sync, but no `.git` yet:
@@ -117,25 +132,25 @@ Shows:
 ┌─────────────────────────────────────────────────────────────────┐
 │ LAPTOP (first time)                                             │
 │                                                                 │
-│ $ git-cloud clone git@github.com:me/project ~/GDrive/project   │
+│ $ git-cloud clone git@github.com:me/project ~/GDrive/project    │
 │                                                                 │
-│ Cloud syncs: src/, .env, .git-remote                           │
-│ Local only: ~/.git-dirs/GDrive/project/                        │
+│ Cloud syncs: src/, .env, .git-remote                            │
+│ Local only: ~/.git-dirs/GDrive/project/                         │
 └─────────────────────────────────────────────────────────────────┘
                               │
                               ▼ (cloud sync)
 ┌─────────────────────────────────────────────────────────────────┐
 │ DESKTOP (after sync)                                            │
 │                                                                 │
-│ $ cd ~/GDrive/project                                          │
-│ ⚠ Run 'git-cloud setup' to enable git                          │
+│ $ cd ~/GDrive/project                                           │
+│ ⚠ Run 'git-cloud setup' to enable git                           │
 │                                                                 │
-│ $ git-cloud setup                                              │
-│ Reading URL from .git-remote...                                │
-│ Done!                                                          │
+│ $ git-cloud setup                                               │
+│ Reading URL from .git-remote...                                 │
+│ Done!                                                           │
 │                                                                 │
-│ $ git status                                                   │
-│ On branch main                                                 │
+│ $ git status                                                    │
+│ On branch main                                                  │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
@@ -144,7 +159,9 @@ Shows:
 | Command | Description |
 |---------|-------------|
 | `git-cloud clone <url> [path]` | Clone with local `.git` storage |
+| `git-cloud init [path]` | Init new repo with local `.git` storage |
 | `git-cloud setup [url] [path]` | Setup git for synced folder |
+| `git-cloud sync [path]` | Sync local git with remote after cloud sync |
 | `git-cloud migrate [path]` | Move existing `.git` to local storage |
 | `git-cloud status` | Show all repos and their state |
 | `git-cloud help` | Show help |

git-cloud

@@ -7,7 +7,7 @@ set -e
 GIT_DIRS="${GIT_DIRS:-$HOME/.git-dirs}"
 CLOUD_DIRS="${CLOUD_DIRS:-$HOME/GoogleDrive:$HOME/Dropbox:$HOME/OneDrive}"
 REMOTE_FILE=".git-remote"
-VERSION="1.3.0"
+VERSION="1.4.0"
 
 # Colors
 red()    { echo -e "\033[0;31m$1\033[0m"; }
@@ -86,6 +86,47 @@ cmd_clone() {
     echo "Tip: Add '$REMOTE_FILE' to your global .gitignore"
 }
 
+# Init new repo with separate git dir
+cmd_init() {
+    local repo_path="${1:-.}"
+
+    # Resolve to absolute path (create if needed)
+    if [ ! -d "$repo_path" ]; then
+        mkdir -p "$repo_path"
+    fi
+    repo_path="$(cd "$repo_path" && pwd)"
+
+    # Check if already a git repo
+    if [ -d "$repo_path/.git" ] || [ -f "$repo_path/.git" ]; then
+        red "Error: Already a git repository"
+        echo "Use 'git-cloud migrate' to move .git to local storage"
+        return 1
+    fi
+
+    local git_dir
+    git_dir=$(get_git_dir "$repo_path")
+
+    if [ -e "$git_dir" ]; then
+        red "Error: Git dir already exists: $git_dir"
+        echo "Remove it first: rm -rf \"$git_dir\""
+        return 1
+    fi
+
+    mkdir -p "$(dirname "$git_dir")"
+
+    blue "Initializing with separate git dir..."
+    echo "  Working tree: $repo_path"
+    echo "  Git dir: $git_dir"
+    echo ""
+
+    git init --separate-git-dir="$git_dir" "$repo_path"
+
+    echo ""
+    green "Done!"
+    echo ""
+    echo "Next: add a remote with 'git remote add origin <url>'"
+}
+
 # Setup git for a folder that was synced (no .git yet)
 cmd_setup() {
     local arg1="$1"
@@ -461,6 +502,7 @@ SETUP (once per machine):
 
 COMMANDS:
   git-cloud clone <url> [path]   Clone repo with .git stored locally
+  git-cloud init [path]          Init new repo with .git stored locally
   git-cloud setup [url] [path]   Setup git for synced folder
   git-cloud sync [path]          Sync local git with remote after cloud sync
   git-cloud migrate [path]       Move existing .git to local storage
@@ -487,6 +529,7 @@ EOF
 # Main
 case "${1:-}" in
     clone)      cmd_clone "$2" "$3" ;;
+    init)       cmd_init "$2" ;;
     setup)      cmd_setup "$2" "$3" ;;
     sync)       cmd_sync "$2" ;;
     migrate)    cmd_migrate "$2" ;;

install.sh

@@ -92,7 +92,7 @@ if ! grep -q '_git_cloud()' "$SHELL_RC" 2>/dev/null; then
 _git_cloud() {
     local cur="${COMP_WORDS[COMP_CWORD]}"
     if [ "$COMP_CWORD" -eq 1 ]; then
-        COMPREPLY=($(compgen -W "clone setup migrate status version help" -- "$cur"))
+        COMPREPLY=($(compgen -W "clone init setup sync migrate status version help" -- "$cur"))
     fi
 }
 complete -F _git_cloud git-cloud