sync

​

Synopsis

​

Status

​

Migration

• Automatic commits: Thread changes are committed automatically
• Orphan branch worktree: Uses git worktree for clean separation
• Background sync: No manual intervention required

​

Previous Functionality

# Check sync queue status
watercooler sync --status

# Force immediate push
watercooler sync --now

​

Current Behavior

watercooler sync

The 'sync' command has been removed.
Thread sync is now handled automatically via the orphan branch worktree.

​

Alternative Commands

​

Check git status

# Check git status in threads directory
cd $(watercooler config show --json | jq -r '.paths.threads_dir')
git status

​

Manual push (if needed)

# Navigate to threads directory
cd watercooler  # or your threads directory

# Check status
git status

# Push if needed
git push origin threads  # or your branch name

​

Verify sync health

# Check overall system health
watercooler health

​

Automatic Sync Behavior

​

When sync happens

1. After thread operations:
   • init-thread
   • say
   • ack
   • handoff
   • set-status
   • set-ball
2. Commit creation:
   • Automatic git commit after each operation
   • Descriptive commit messages
   • No user intervention required
3. Push behavior (if configured):
   • Can be automatic or manual depending on configuration
   • Check config: watercooler config show

​

Verify automatic sync

# Make a change
watercooler say test-thread --title "Test" --body "Testing sync"

# Check git log
cd watercooler
git log -1
# Should show automatic commit

​

Configuration

[git]
auto_commit = true    # Default: true
auto_push = false     # Default: false (manual push)
branch = "threads"    # Branch name for threads

watercooler config show

​

Troubleshooting

​

Sync not working

1. Check git status:
   cd watercooler
   git status
   
2. Verify git config:
   git config --list
   
3. Check remote:
   git remote -v
   
4. Run health check:
   watercooler health
   

​

Manual sync recovery

# Navigate to threads
cd watercooler

# Check for uncommitted changes
git status

# Commit if needed
git add .
git commit -m "Manual sync"

# Push
git push origin threads

​

Migration from Old Version

1. Verify orphan branch setup:
   cd watercooler
   git branch
   # Should show orphan branch for threads
   
2. Check worktree:
   git worktree list
   
3. Test automatic sync:
   watercooler say test --title "Test" --body "Testing new sync"
   cd watercooler
   git log -1
   # Should show automatic commit
   

​

Related Information

• Configuration - View sync configuration
• Health Check - Verify system health
• Git documentation on worktrees