Documentation

Understanding Version History

Learn how Augment tracks and organizes file versions, and master the tools for navigating through your file's complete history.

How Versioning Works

Augment automatically creates a new version every time you save a file. Each version is a complete snapshot of your file at that moment in time, allowing you to go back to any previous state without losing your current work.

Automatic Versions

Created every time you save a file

Manual Snapshots

Created when you manually create a checkpoint

Scheduled Versions

Created at regular intervals (hourly, daily)

Viewing and Comparing Versions

Augment provides multiple ways to view and compare different versions of your files.

Preview Mode

View file contents without opening the original application

Quick preview of text files
Image thumbnails and previews
Document structure view
Metadata information

Side-by-Side Comparison

Compare two versions to see exactly what changed

Highlighted differences
Line-by-line comparison
Visual diff for images
Change statistics

Version Search

Find specific versions based on content or metadata

Search within version content
Filter by date range
Filter by file size
Search by modification type

Version Information

Each version contains detailed metadata to help you understand what changed and when.

Basic Information

  • • Timestamp: Exact date and time of creation
  • • File Size: Size of the file at that version
  • • Application: Which app was used to modify the file
  • • User: Who made the changes (in multi-user environments)

Advanced Metadata

  • • Change Type: What kind of modification was made
  • • File Hash: Unique identifier for the version
  • • Compression: Storage optimization information
  • • Labels: Custom tags you've added

Navigation Tips & Tricks

Master these techniques to efficiently navigate through your version history.

Timeline View

Use the timeline slider to quickly jump between versions

Tip: Drag the timeline handle or click on specific points to navigate

Keyboard Shortcuts

Navigate versions quickly with keyboard shortcuts

Tip: Use ← → arrow keys to move between versions, Space to preview

Version Labels

Add custom labels to important versions for easy identification

Tip: Right-click any version and select "Add Label" to mark it

Bulk Operations

Select multiple versions for batch operations

Tip: Hold Cmd while clicking to select multiple versions

Version Limits and Cleanup

To manage storage space efficiently, Augment automatically cleans up old versions based on your space settings. You can configure these policies to match your needs.

Default Cleanup Policy

  • • Keep all versions from the last 7 days
  • • Keep daily snapshots for the last 30 days
  • • Keep weekly snapshots for the last 90 days
  • • Keep monthly snapshots beyond that

Protected Versions

  • • Manually labeled versions are never deleted
  • • Versions marked as "important" are preserved
  • • Recent versions (last 24 hours) are always kept
  • • You can manually protect any version