Unfudged.io

What is Unfudged.io?

Unfudged.io is a filesystem flight recorder that captures every file change in real time, allowing you to rewind any file to any second without requiring commits. It acts as a safety net for developers, especially when using AI agents that can accidentally wipe or corrupt files. The tool continuously records all filesystem events—every save, every second—using FSEvents on macOS and inotify on Linux. It respects .gitignore, skips binaries via magic-number detection, and uses a 3-second smart debounce to optimize performance, consuming less than 1% CPU and under 100MB RAM. Content is hashed with BLAKE3 and stored in a SQLite database with ACID guarantees, ensuring content-addressed deduplication so identical files are stored only once. All data remains local-only, never leaving your machine. Point-in-time restore allows you to recover any file to any specific second, and manual pruning with `unf prune` reclaims space. The tool supports relative time ranges (e.g., 5m, 1h, 2d) and absolute ISO 8601 timestamps, with JSON output for machine readability. It can operate on any project from anywhere using `--project <PATH>`. Installation is simple with a single command, and it's open source under MIT/Apache-2.0. Use cases include recovering from AI agent mistakes—such as accidental file deletion, overwriting configuration files, or reverting good work—and protecting against human errors like closing an editor without saving. Unlike Git, which requires manual commits, or Ctrl+Z, which fails after closing the editor, Unfudged.io provides continuous, automatic versioning. It also outperforms Time Machine, which runs hourly, by recording every second. The tool is ideal for developers working with AI agents, managing critical configuration files, or needing granular file history. Technical details include BLAKE3 hashing for integrity, SQLite for reliable storage, and a lightweight footprint that makes it suitable for continuous background use.

Use Cases

Key Features

real time file change capture point in time file restore AI agent safety net .gitignore respect binary file skipping smart debounce optimization BLAKE3 content hashing SQLite ACI3D storage local only data manual space pruning

Who is it for?

developers, AI agent users, software engineers, DevOps teams, data recovery specialists, open source contributors

Similar Tools