/push

Name

push

Description

Commit and push vault changes to Git with smart commit messages. Auto-stages files, creates meaningful commits, and syncs with remote. Use after making vault changes or at end of day.

Allowed Tools

Bash, Read, Glob

user-invocable

true

# Git Push Skill

Automates Git workflow to save your notes with meaningful commit messages and push to remote repository.

## Usage

Invoke with `/push` or ask Claude to save/commit your changes.

### Basic Usage
```
/push
```

### With Custom Message
```
/push "Completed weekly review"
```

## What This Skill Does

1. **Stages All Changes**
   - Adds all modified files
   - Includes new files
   - Removes deleted files

2. **Creates Smart Commit Message**
   - Uses provided message, or
   - Auto-generates from changes
   - Includes timestamp

3. **Syncs with Remote**
   - Pulls latest changes
   - Pushes to remote repository
   - Handles conflicts gracefully

## Commit Message Format

### Automatic Messages
Based on your changes:
```
Daily note for 2024-01-15

- Added: Daily Notes/2024-01-15.md
- Modified: Inbox/idea.md
```

### With Timestamp
```
[2024-01-15 09:30] Completed weekly review
```

### Path-Based Messages
Smart messages based on changed files location:
- Daily Notes/ → "Update daily note - [date]"
- Templates/ → "Update templates"
- Inbox/ → "Process inbox items"
- Archives/ → "Archive notes"

## Workflow Integration

### Morning Routine
```
/daily          # Create daily note
# ... work on notes ...
/push "Morning planning complete"
```

### End of Day
```
# Complete daily reflection
/push           # Auto-message with summary
```

### After Weekly Review
```
/weekly         # Run weekly review
/push "Weekly review complete"
```

## Git Operations

### Standard Flow
1. `git add .` - Stage all changes
2. `git commit -m "message"` - Create commit
3. `git pull --rebase origin main` - Get remote changes
4. `git push origin main` - Push to remote

### Safety Checks
- Verify Git repository exists
- Check for uncommitted changes
- Ensure remote is configured
- Never force push

## Security Considerations

### Use .gitignore for
```
CLAUDE.local.md
.obsidian/workspace*
.obsidian/cache
.trash/
.DS_Store
```

## Troubleshooting

### Push Rejected?
Pull first, then push again:
```bash
git pull --rebase origin main
git push origin main
```

### Not a Git Repository?
```bash
git init
git remote add origin [URL]
```

## Integration

Works with:
- `/daily` - Commit after creating daily note
- `/weekly` - Commit after weekly review
- `/onboard` - No git needed for context loading