GitHub Push - Secure Auto-Push Tool
Automated GitHub push with:
- Auto SSH Config: Auto-detect and load SSH keys
- Auto Remote Config: Auto-add git remote origin
- Auto Conflict Resolution: Auto pull + rebase + force
- Anti-Ban Mechanism: Rate limiting + commit batching + smart validation
Installation
No external dependencies required. Uses standard Git CLI (always available).
Usage Examples
# Quick push (auto-configures everything)
python3 scripts/github_upload.py --repo owner/repo --path ./files --message "Update"
# Dry run test (no actual push)
python3 scripts/github_upload.py --repo owner/repo --path ./files --dry-run
# Force push (auto-resolves conflicts)
python3 scripts/github_upload.py --repo owner/repo --path ./files --force
# Show version info
python3 scripts/github_upload.py --version
Configuration
Create config.yaml for persistent settings:
defaults:
safe_mode: true
min_delay: 3 # seconds between operations
max_delay: 5 # seconds between operations
batch_commits: true
enable_validation: true
dry_run: false
safety:
max_commits_per_hour: 100
max_pushes_per_hour: 50
min_time_between_pushes: 180 # 3 minutes cooldown
Safety Thresholds
| Metric | Default | Description |
|---|---|---|
| Delay between ops | 3-5s | Randomized delay |
| Push cooldown | 180s | Min time between pushes |
| Max pushes/hour | 50 | Anti-spam limit |
| Max commits/hour | 100 | Anti-automation limit |
Troubleshooting
Error: "Too frequent pushes"
Solution: Wait at least 3 minutes before next push.
Error: "Repository not found"
Solution: Check repository exists and you have push access. Verify SSH key is added to GitHub.
Error: "Permission denied (publickey)"
Solution:
# Load SSH key
ssh-add ~/.ssh/id_ed25519
# Verify SSH connection
ssh -T git@github.com
Error: "Merge conflict"
Solution: The script handles this automatically with pull + rebase + force. Check repository state if issue persists.
Error: "Validation failed"
Solution:
- Check path exists and is accessible
- Verify files don't exceed 100MB (GitHub limit)
- Check for suspicious patterns (e.g., .env, id_rsa)
When Not to Use
- Just viewing GitHub content
- Creating issues or PRs
- Code review
References
references/- Detailed config and API docsscripts/- Full code examples
MIT License - OpenClaw Skill Standard