# UNF

> UNF* continuously records every version of every file in your workspace so you can rewind to any second — no commits required.

UNF* is a local-first, continuous file versioning tool that records every save to your workspace in real time, giving you a complete point-in-time history without requiring any Git commits. It is designed specifically for the AI-agent era, where autonomous tools can mass-overwrite, delete, or corrupt files before you have a chance to react. UNF* runs silently in the background at under 1% CPU and under 100MB RAM, storing all snapshots locally with no cloud, no accounts, and no telemetry. It is completely free with no subscription or usage limits.

- **Continuous recording** — *uses FSEvents on macOS and inotify on Linux to capture every file save with a 3-second smart debounce, respecting `.gitignore` and skipping binaries.*
- **Content-addressed storage** — *uses BLAKE3 hashing and SQLite with ACID guarantees; identical file contents are stored only once, keeping storage lean.*
- **Point-in-time restore** — *run `unf restore --at <TIME>` to rewind any file or entire workspace to any second in history using relative (e.g., `5m`, `1h`) or absolute ISO 8601 timestamps.*
- **AI burst detection** — *automatically identifies mass-change events from AI agents and creates safety checkpoints around them for easy rollback.*
- **Automatic retention decay** — *keeps full history for 24 hours, hourly snapshots for 7 days, and daily snapshots for 30 days, then prunes automatically.*
- **Session recap** — *`unf recap` summarizes session activity, files touched, and AI bursts detected, with `--json` output for machine-readable pipelines.*
- **Desktop App & CLI** — *install the Desktop App via Homebrew Cask (includes the CLI) or install the CLI alone with `brew install cyrusradfar/unf/unf`, then run `unf watch` to start.*
- **Local-first & private** — *all data lives in `~/.unfudged/`; nothing leaves your machine, no network calls, no telemetry.*
- **Rich diff & log commands** — *`unf log`, `unf diff`, and `unf cat` let you inspect exactly what changed, when, and by how much before committing to a restore.*

## Features
- Continuous file versioning without commits
- Point-in-time restore for any file or workspace
- AI agent burst detection and safety checkpoints
- BLAKE3 content-addressed deduplication
- SQLite storage with ACID guarantees
- Automatic retention decay (24h full, 7d hourly, 30d daily)
- FSEvents (macOS) and inotify (Linux) filesystem watching
- Session recap with AI burst summary
- Machine-readable JSON output for all commands
- Local-only storage — no cloud, no telemetry
- Respects .gitignore, skips binaries
- Desktop App and CLI installation options

## Integrations
Git, Homebrew, SQLite

## Platforms
MACOS, LINUX, API

## Pricing
Open Source

## Version
0.16.1

## Links
- Website: https://www.unfudged.io
- Documentation: https://www.unfudged.io/#docs
- Repository: https://github.com/cyrusradfar/unf
- EveryDev.ai: https://www.everydev.ai/tools/unfudged