aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMax Resnick <max@ofmax.li>2025-02-16 10:21:47 -0800
committerMax Resnick <max@ofmax.li>2025-02-16 10:21:47 -0800
commit26086fe3cd28d2effd5599b85edffc9c624949a6 (patch)
treed7be62cb7a43e557993847258612452a124410c5 /README.md
parent7b597be4b9576f6d045169c91ef30a94d6abfdef (diff)
downloadgit-snapshot-26086fe3cd28d2effd5599b85edffc9c624949a6.tar.gz
docs: update readmeHEADCHECKPOINTmaster
Diffstat (limited to 'README.md')
-rw-r--r--README.md27
1 files changed, 26 insertions, 1 deletions
diff --git a/README.md b/README.md
index c17a1b3..74861ce 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,28 @@
# git-snapshot
-A stupid script that snapshots a git repo via bundle and uploads to an object store.
+A command-line tool for backing up git repositories to Amazon S3.
+
+## Features
+
+- Backs up multiple git repositories to S3 using git bundles
+- Tracks backup state using checkpoint tags
+- Write-ahead logging (WAL) for backup operations
+- Only creates new backups when changes are detected
+- Configurable S3 bucket and prefix paths
+
+## Usage
+
+```bash
+gitsnap backup <repositories-dir> <s3-bucket> [-p PREFIX]
+```
+
+Where:
+- `repositories-dir`: Directory containing git repositories to backup
+- `s3-bucket`: Name of the S3 bucket for storing backups
+- `-p, --prefix`: Optional prefix for objects in S3 (default: 'gitsnap')
+
+## Requirements
+
+- Python 3
+- boto3
+- sh