Chukke documentation

History and Recovery

Restore earlier local snapshots while keeping a separate backup strategy.

Before every content-changing save of an existing workspace document, Chukke records the previous disk content as a local history snapshot. An unchanged save creates no snapshot, and a new file’s first save has no previous version to retain. History lives in the app’s macOS application-data container rather than inside your workspace.

Files opened individually outside the active workspace do not receive Chukke history, snapshots, restore, or a recovery copy. Saving one into the active workspace through Save As… converts it to a workspace document for subsequent history behaviour, but does not create history for its earlier external edits.

Retention limits

History is intentionally bounded:

  • up to 50 versions per document
  • up to 500 MB across all history

When a limit is reached, Chukke automatically removes the oldest snapshots as new ones are recorded. The global size limit can remove snapshots from other documents or workspaces; no manual cleanup is needed.

Inspect and restore

Open the History panel for a document to browse snapshots, inspect a diff, and restore the version you choose. “Before save at” marks when the shown content was replaced. When a comparison exceeds 512 KiB combined, either document exceeds 2,000 lines, or the line-count product exceeds 2,000,000, Chukke skips line-by-line diff computation and changed-line totals but still shows both complete documents side by side. Save any unsaved edits before restoring; Restore is disabled while the document has unsaved changes. A restore follows the same reviewable workflow as other document changes and retains the disk content it replaces, subject to the history limits.

Backup considerations

History is a recovery convenience for recent edits. It does not preserve every version forever, and clearing application data removes it. Keep important work in Git, Time Machine, or another complete backup system.

Clear local history

Use Chukke Settings to clear app-owned history. This does not delete the original documents in your workspace.