Backup Tool - CLI Project Backup Manager

A simple and powerful CLI tool for creating, managing and restoring project backups.

Installation

One-Line Install (Fastest)

Manual Install

1. Download installer: install.ps1
2. Run installer:
   .\install.ps1
3. Restart terminal and use
   backup
   commands

Direct Download

1. Download
   backup.exe
   from latest release
2. Copy to any directory in your PATH

Uninstallation

Or download and run: uninstall.ps1

Commands

backup init

Initialize current directory for backup management.

What happens:

• Creates
  .backup-config.json
  file with unique project ID
• Sets up backup directory in
  %APPDATA%/ProjectBackup/{project-id}/
• Configures default exclusions

backup create

Create new project backup.

Features:

• Automatically excludes
  node_modules/
  ,
  .git/
  ,
  build/
  ,
  dist/
  and other system folders
• Shows archiving progress bar
• Compresses files to ZIP format
• Supports projects up to 1GB

backup list

Display interactive list of all backups.

Capabilities:

• View all backups with sizes and dates
• Display backup age (minutes, hours, days ago)
• Navigate with ↑/↓ arrows
• Quick actions:
  • Enter
    - load backup
  • r
    - rename backup
  • d
    - delete backup
  • q
    - quit

backup load

Load backup into current directory.

WARNING: All files in current directory will be deleted! Operation requires confirmation.

File Exclusions

By default excludes:

• node_modules/
  - Node.js dependencies
• .git/
  - Git repository
• build/
  ,
  dist/
  - Build folders
• *.tmp
  ,
  *.log
  - Temporary files
• .env*
  - Environment files
• *.exe
  ,
  *.dll
  - Executable files
• target/
  - Rust/Java build
• bin/
  ,
  obj/
  - .NET build
• .vs/
  ,
  .vscode/
  - IDE files
• __pycache__/
  ,
  *.pyc
  - Python cache

Storage Structure

%APPDATA%/ProjectBackup/
├── {project-uuid-1}/
│   ├── backup_20240119_143022.zip
│   ├── backup_20240119_150315_MyFeature.zip
│   └── backup_20240120_091500_Release.zip
└── {project-uuid-2}/
    └── ...

Example Usage

Typical Workflow

1. Initialize new project:

2. Create backup before important changes:

3. View all backups:

4. Restore to previous state:

Technical Details

• Language: Go 1.21+
• Archive format: ZIP with basic compression
• Supported OS: Windows
• Max project size: 1GB
• Storage: Local in
  %APPDATA%/ProjectBackup

Features

• Simple to use - intuitive interface
• Beautiful UI - colored output and progress bars
• Fast operation - efficient archiving
• Safe - confirmation for critical operations
• Compact - single executable without dependencies

Version: 1.0
Platform: Windows