Keep track of changes with a clean versioned history

keeptrack is a Babashka script that monitors URLs for changes and maintains a versioned history of content. When content changes, it creates timestamped versions and can optionally trigger custom handlers.

bbin install io.github.200ok-ch/keeptrack

keeptrack [options] <URL>

• -d, --debug - Print debug messages
• -h, --handler=COMMAND - Command to execute when new version is created
• -s, --storage=PATH - Storage directory (default: ~/.keeptrack)
• -t, --tempdir=PATH - Temporary files directory (default: /tmp/keeptrack)

When using the --handler option, you can use these placeholders:

• %o - Path to the old file
• %n - Path to the new file
• %l - Previous version
• %v - New version

keeptrack https://api.example.com/data.json

keeptrack -s ~/my-tracking https://api.example.com/data.json

keeptrack --handler="echo 'New version: %n'" https://api.example.com/data.json

1. Downloads content from the specified URL
2. Compares with the latest version (if exists)
3. Creates timestamped file if content changed
4. Updates symlink to point to latest version
5. Executes custom handler if specified

Files are stored with the format: {timestamp}-v{version}.json

Example: api-data-20250623T143052Z-v5.json

• Babashka
• curl
• cmp
• date