# kimono-koans/httm

Interactive, file-level Time Machine-like tool for ZFS/btrfs/nilfs2 (and even Time Machine and Restic backups!)

Repository: https://github.com/kimono-koans/httm
Canonical: https://ross.abutalabs.com/products/httm
Homepage: https://crates.io/crates/httm
Language: Rust
License: MPL-2.0
License Family: copyleft
Topics: zfs, rust, unix-shell, unix, unix-command, zsh, zfs-snapshots, zfsonroot, command-line-tool, shell, freebsd, linux, btrfs, btrfs-snapshots, cli, command-line, terminal, nilfs, homelab, restic
Last push: 2026-08-21T08:04:11+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 90, longevity 100
- inputs: {"age_days": 1640, "days_push": 12, "days_rel": 64, "gap_med": 2, "n_releases_24m": 48}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1658, forks 35 (observed 2026-08-28T04:05:18.241561+00:00)

## What it is
httm is a fast, interactive CLI tool for browsing, listing, and restoring file versions stored in ZFS, btrfs, and nilfs2 snapshots, as well as Time Machine and Restic backups. It deduplicates file versions by modify time and size, supports recursive search for deleted files, and offers interactive browse/select/prune/restore modes.

## Use cases
- find and restore previous versions of files from zfs snapshots
- browse deleted files hidden in btrfs snapshots
- recover a file from a time machine backup from the command line
- list unique versions of a file across all local zfs pools
- prune snapshots that contain a specific file
- preview snapshot file versions with diff before restoring
- roll forward to a previous snapshot without destroying interstitial snapshots

## When to choose
- you use ZFS, btrfs, or nilfs2 and want Time Machine-like file-level restore
- you need to search snapshots for deleted or historical file versions quickly
- you want an interactive terminal workflow for snapshot browsing and restoration
- you manage Restic or Time Machine backups and need CLI file-version lookup

## When to avoid
- you need full-disk or full-dataset backup creation rather than file-version browsing
- your filesystem has no snapshot support and you don't use rsync-ed backups
- you want a GUI backup solution

## Facets
- artifact type: cli-tool
- maturity: active
- function: backup, file-system, cli, search-engine
- domain: files, self-hosted
- platform: bsd, cli, rust
- tags: zfs, btrfs, nilfs2, snapshots, file-restore, time-machine, restic, terminal-ui, interactive, command-line, backup, linux, macos

## Member repositories
- kimono-koans/httm (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.241561+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:44:44.906855+00:00, confidence not recorded.
  - readme: https://github.com/kimono-koans/httm (fetched 2026-08-28T04:05:18.241561+00:00, sha 4a83a34427ab)
  - registry_crates: https://crates.io/api/v1/crates/httm (fetched 2026-08-29T11:17:17.808021+00:00, sha 4f29d388d736)
- Data as of 2026-08-30T08:39:29.467469+00:00.