Repo Bundler

📦 Repo Bundler v2.0.0 is a utility toolkit for bundling, analyzing, converting, and managing repository data. It provides a thorough CLI with timestamped logging, data export in multiple formats, and full activity history tracking.

Commands

All commands accept optional <input> arguments. When called without arguments, they display recent entries from their respective logs. When called with input, they record a new timestamped entry.

Utility Commands

Data Storage

All data is stored locally in ~/.local/share/repo-bundler/:

• history.log — Master activity log with timestamps for every operation
• run.log, check.log, convert.log, etc. — Per-command log files storing timestamp|input entries
• export.json, export.csv, export.txt — Generated export files

Each entry is stored in pipe-delimited format: YYYY-MM-DD HH:MM|value. The data directory is created automatically on first use.

Requirements

• Bash 4.0+ (uses set -euo pipefail, local variables)
• Standard Unix tools: date, wc, du, tail, grep, sed, basename, cat
• No external dependencies, API keys, or network access required
• Works on Linux, macOS, and WSL

When to Use

1. Bundling a repository for AI consumption — Use run to process and pack repo contents into a single file suitable for LLM context windows
2. Analyzing repository structure — Use analyze to examine file counts, directory layout, and content patterns across a codebase
3. Comparing repository snapshots — Use compare to track differences between two versions or branches of a repository bundle
4. Batch processing multiple repos — Use batch to queue and process several repositories in sequence with logged results
5. Exporting bundler history for auditing — Use export json to generate a structured record of all bundler operations for compliance or review

Examples

# Bundle a repository and log the operation
repo-bundler run my-project-v2.3

# Analyze repository structure
repo-bundler analyze ./src --depth=3

# Compare two repository snapshots
repo-bundler compare main-branch feature-branch

# Batch process multiple repos
repo-bundler batch repo1 repo2 repo3

# Export all history as JSON
repo-bundler export json

# Search for a specific entry across all logs
repo-bundler search "my-project"

# View summary statistics
repo-bundler stats

# Check system health
repo-bundler status

Output

All commands output structured text to stdout. Use standard shell redirection to capture output:

repo-bundler stats > summary.txt
repo-bundler export json  # writes to ~/.local/share/repo-bundler/export.json

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com