Documentation

Troubleshooting Guide

Find solutions to common issues and learn how to diagnose and resolve problems with Augment. Most issues can be resolved quickly with the right approach.

Quick Diagnostic Steps

Follow these steps to diagnose most issues systematically.

1

Check System Status

Verify basic system requirements and status

  • Confirm macOS version (11.0+)
  • Check available disk space
  • Verify Augment is running
  • Review system permissions
2

Review Error Messages

Collect and analyze any error messages

  • Note exact error text
  • Check Console app for Augment logs
  • Screenshot error dialogs
  • Record when errors occur
3

Test Basic Functions

Verify core functionality is working

  • Try creating a new space
  • Test file versioning
  • Attempt version restoration
  • Check space settings
4

Gather Information

Collect system information for support

  • Note Augment version number
  • Record macOS version
  • List affected spaces/files
  • Document reproduction steps

Common Issues & Solutions

Here are the most frequently encountered issues and their solutions.

Installation & Setup

App won't launch after installation

Symptoms:
  • Application crashes on startup
  • No response when double-clicking
Solutions:
  1. 1Right-click Augment and select "Open" to bypass Gatekeeper
  2. 2Check that you're running macOS 11.0 or later
  3. 3Restart your Mac and try again
  4. 4Reinstall Augment with admin privileges

Permission denied errors

Symptoms:
  • Cannot create spaces
  • Access denied messages
Solutions:
  1. 1Grant Full Disk Access in System Preferences > Security & Privacy
  2. 2Run Augment as administrator
  3. 3Check folder permissions for target directories
  4. 4Restart Augment after granting permissions

Performance Issues

Slow file operations

Symptoms:
  • Long delays when saving files
  • High CPU usage
Solutions:
  1. 1Check available disk space (need 10%+ free)
  2. 2Reduce version frequency in space settings
  3. 3Exclude large files from versioning
  4. 4Run storage cleanup to free up space

High memory usage

Symptoms:
  • System slowdown
  • Memory pressure warnings
Solutions:
  1. 1Restart Augment to clear memory cache
  2. 2Reduce number of active spaces
  3. 3Close unused applications
  4. 4Check for memory leaks in Activity Monitor

Version Management

Versions not being created

Symptoms:
  • No new versions appear
  • Version count stays the same
Solutions:
  1. 1Check that the file is within a protected space
  2. 2Verify space is active and not paused
  3. 3Ensure file type is not excluded
  4. 4Check storage limits haven't been exceeded

Cannot restore previous version

Symptoms:
  • Restore button grayed out
  • Error during restoration
Solutions:
  1. 1Check file permissions on target location
  2. 2Ensure original file isn't open in another app
  3. 3Verify sufficient disk space for restoration
  4. 4Try copying version to new location instead

Emergency Procedures

For critical issues that require immediate attention.

Database Corruption

Critical

If Augment's database becomes corrupted

  1. 1Quit Augment immediately
  2. 2Backup your spaces folder
  3. 3Run database repair tool
  4. 4Restore from backup if needed

Data Recovery

High

If files are accidentally deleted or corrupted

  1. 1Don't panic - versions are still safe
  2. 2Open Augment and locate the file
  3. 3Use "Show Deleted Files" option
  4. 4Restore from most recent good version

Complete System Failure

Critical

If Augment won't start at all

  1. 1Try safe mode startup
  2. 2Check system logs for errors
  3. 3Reinstall Augment
  4. 4Contact support with logs

When to Contact Support

If you've tried the solutions above and still need help, our support team is here to assist you.

Before Contacting Support

  • • Try the diagnostic steps above
  • • Note your Augment version number
  • • Record your macOS version
  • • Gather any error messages
  • • Document steps to reproduce the issue

Contact Information

support@augment-app.com
Response within 2 hours
Include system logs when possible