UNF*

Your AI agent just wiped your workspace. You didn't commit.

UNF* recorded every version. Rewind any file to any second.
No commits required.

Open source · MIT / Apache-2.0 · Star us on GitHub

UNFUDGED

4,427

snapshots

401

files

projects

Feb 12 Feb 15 Feb 18

▾ acme-co/

justfile7

Cargo.lock21

src/main.rs47

src/engine.rs23

src/lib.rs18

--- 1861 lines hidden ---

@@ -1862,7 +1862,7 @@

18631863[package]

18641864name = "unfudged"

1865version = "0.7.1"

1865version = "0.7.8"

18661866dependencies = [

18671867 "anyhow",

18681868 "assert_cmd",

Install in seconds with one command.

# macOS (universal binary, includes CLI) $ brew install --cask cyrusradfar/unf/unfudged

# macOS + Linux $ brew install cyrusradfar/unf/unf

$ curl -fsSLO https://downloads.unfudged.io/releases/latest/unf_arm64.deb $ sudo dpkg -i unf_arm64.deb

$ curl -fsSLO https://downloads.unfudged.io/releases/latest/unf_amd64.deb $ sudo dpkg -i unf_amd64.deb

# Requires Rust 1.80+ $ git clone https://github.com/cyrusradfar/homebrew-unf.git $ cd homebrew-unf $ cargo build --release $ cp target/release/unf /usr/local/bin/

Read the docs

Files disappear between commits.

An AI agent rewrites 47 files. You weren't watching.

You delete the wrong branch. No backup.

A refactor breaks everything. The working version is gone.

You close the editor. It saved over the good version.

Git can't help. You didn't commit.

Ctrl+Z can't help. You closed the editor.

Time Machine can't help. It runs hourly.

UNF* records continuously. Every save, every second.

If your filesystem saw it, UNF* has it.

$ unf watch Watching /Users/agent/myapp ... 2h of work, context compacts, agent resumes ... $ unf recap --since 3h -- /Users/agent/myapp -- Session 1 14:02 - 16:18 (2h 16m, 847 edits, 23 files) git: main 5 uncommitted files Last edit: tests/fixtures/seed.json 3 minutes ago # agent: I remember the auth refactor. Not the seed edit. # One-char change — let me see before I submit. $ unf diff --at 30m tests/fixtures/seed.json - "email": "alice@example.com" + "email": "alicia@example.com" # agent: tests/auth/session_test.rs asserts "alice". # That "typo fix" would break the test. Reverting. $ unf restore --at 30m tests/fixtures/seed.json Restored tests/fixtures/seed.json

Real unf output. Agent flow after context compaction.

How it works

WATCH

FSEvents on macOS, inotify on Linux. Respects .gitignore by default, with an opt-in override. Skips binaries. 3-second smart debounce, capped at 15 seconds so sustained bursts still land while they are running.

<1% CPU · <100MB RAM

STORE

BLAKE3 content hashing. SQLite with ACID guarantees. Content-addressed, so identical files are stored once. Local-only, always.

REWIND

Point-in-time restore for any file, any second. Manual pruning with unf prune to reclaim space.

Read the technical deep dive

Commands

unf watch	Start recording the current directory
unf unwatch	Stop recording (history preserved)
unf status	Watcher status + snapshot stats
unf log <file>	Timeline of every version of a file
unf log --since / --until	Filter log to a time range
unf diff --at "5m"	What changed in the last 5 minutes
unf restore --at TIME	Rewind files to any point in time
unf cat --at TIME	View file contents at a point in time
unf recap	Summarize session activity + context
unf list	Show all watched directories
unf prune	Remove snapshots older than a cutoff you choose
unf prune --all-projects	Same across every project. Cannot be undone; asks first if it would empty a project
unf stop / restart	Control the background daemon
unf config	Show storage location and disk usage
unf config --move-storage	Move storage to a new location

Time formats

Relative: 5m 2h 1d

Local: "2026-08-25 21:10:03" — exactly what unf log prints, trailing -0600 offset and all. Quote it, or the shell reads the offset as a flag.

UTC: 2026-08-25T21:10:03Z

Seconds are required. 2026-08-25 and 2026-08-25 21:10 are rejected.

Global flags

--json — machine-readable output for all commands

--project <PATH> — operate on any project from anywhere

What gets recorded

All text files, recursively. Respects .gitignore. Skips binaries by magic-number detection. Skips build and dependency directories: .git, node_modules, target, dist, build, and five more. They are large and they change on every build.

Run unf watch --force-watch-gitignore to also record gitignored files and hidden dotfiles. Secrets in those files, such as .env.local, go into the recording.

Run unf watch --unignore-dir target to record one skipped directory in one project. Most projects also gitignore those directories, so pass both flags together to record them.

The same flag records three paths inside .git that git itself does not track: unf watch --unignore-dir .git/hooks, plus .git/config and .git/info/exclude. Cost is low, unlike target: the 14 default hooks are inert .sample files that never change. Everything else under .git stays refused, including the object store and the refs. Submodules are not covered.

Storage

Defaults to ~/.unfudged/. Move anywhere with unf config --move-storage. Nothing inside your project directory. Content-deduplicated.

Install

# macOS (universal binary, includes CLI) $ brew install --cask cyrusradfar/unf/unfudged

# macOS + Linux $ brew install cyrusradfar/unf/unf

$ curl -fsSLO https://downloads.unfudged.io/releases/latest/unf_arm64.deb $ sudo dpkg -i unf_arm64.deb

$ curl -fsSLO https://downloads.unfudged.io/releases/latest/unf_amd64.deb $ sudo dpkg -i unf_amd64.deb

# Requires Rust 1.80+ $ git clone https://github.com/cyrusradfar/homebrew-unf.git $ cd homebrew-unf $ cargo build --release $ cp target/release/unf /usr/local/bin/

Then: unf watch. That's it.

Fast <1% CPU. You won't notice it.

Local-first No cloud. Nothing leaves your machine.

Free No subscription. No limits.

Secure No accounts. No telemetry. No network.

Use cases

Agent mass-overwrote your source

Your AI agent refactored 30 Rust files, hit an error on file 27, and reverted everything to stale versions. Three hours of good work — gone.

$ unf log --since 3h --include "*.rs" $ unf diff --at 10m $ unf restore --at 10m -y

Agent deleted your .env

The agent decided .env was "generated" and deleted it. API keys, database URLs, local config. Not in git. Not anywhere.

$ unf log .env $ unf cat .env --at 5m $ unf restore --at 5m .env -y

Agent's cleanup script went wrong

You asked the agent to "clean up build artifacts." It wrote a shell script that rm -rf'd src/ instead of dist/.

$ unf diff --at 1m $ unf restore --at 2m --dry-run $ unf restore --at 2m -y

Agent "fixed" your dependencies

The agent removed 6 "unused" crates from Cargo.toml. Four were behind feature flags. CI is red.

$ unf log Cargo.toml $ unf cat Cargo.toml --at 1h $ unf restore --at 1h Cargo.toml -y

Agent reformatted everything

The agent ran Prettier with the wrong config and rewrote 200 TypeScript files. It committed before you noticed. git revert gives you one commit. UNF* has every file.

$ unf log --since 30m --include "*.ts" $ unf diff --at 30m $ unf restore --at 30m -y

Agent replaced your test fixtures

Your hand-crafted SQL seed data and JSON fixtures got overwritten with generic placeholders. A week of edge cases, gone.

$ unf log --include "fixtures/*" $ unf diff --at 20m $ unf restore --at 20m -y

Agent deleted your migration files

The agent saw 47 SQL migration files and decided they were "redundant." Production depends on them running in order.

$ unf log --include "migrations/*.sql" $ unf diff --at 15m $ unf restore --at 15m -y

Squash merge ate intermediate work

You squash-merged a feature branch. Git only has the final result. The 40 intermediate versions across 3 days? Git doesn't know they existed.

$ unf log --since 3d --include "*.py" $ unf diff --from 3d --to 1d $ unf cat app/models.py --at 2d

Agent lost context mid-session

Context window overflow. The agent crashed 2 hours into a refactor across 4 repos. The new agent needs to pick up exactly where the old one left off.

$ unf recap --global --json $ unf log --sessions --since 2h $ unf diff --session

What happened while you were away?

You left an agent running overnight. It touched 80 files across 3 projects. What did it do?

$ unf log --global --since 8h $ unf diff --at 8h $ unf restore --at 8h --dry-run