Stop backing up files you'll never restore.

Every Time Machine snapshot copies your node_modules, .venv, target, DerivedData; gigabytes of files you can rebuild with one command. With git worktrees and AI coding agents spinning up parallel copies of every project, that waste compounds fast.

Asimov scans your home directory, finds dependency folders next to their config files, and tells Time Machine to skip them. Install once, run daily, forget it exists.

The last release from Asimov's original maintainer, available in homebrew-core:

brew install asimov
brew services start asimov

It's from 2020 and predates everything below — no config file, far fewer ecosystems, and a full scan on every run. A new stable lands once the beta settles.

Where active development lives: 30+ more ecosystems, a config file, --dry-run, and caching that takes typical runs from ~75s to ~1–2s.

curl -fsSL https://raw.githubusercontent.com/AsimovMac/asimov/v0.9.0-beta.2/scripts/install-remote.sh \
  | ASIMOV_REF=v0.9.0-beta.2 bash

Installs to ~/.local/bin. Feedback and bug reports very welcome — open an issue.

asimov --dry-run    # preview what would be excluded — changes nothing
asimov              # apply

That's it. Asimov then runs itself once a day, every day. Add --stats to either command to see sizes and how much space you're saving.

See other install methods to build from source.

$ asimov --dry-run --stats

⏳ Scanning for dependency directories…
📦 Processing matches…
- Would exclude: ~/Code/myapp/node_modules (412M).
- Would exclude: ~/Code/myapp/.next (89M).
- Would exclude: ~/Code/api/.venv (1.2G).
- Would exclude: ~/Code/rust-cli/target (2.4G).
- Would exclude: ~/Code/worktrees/feature-auth/node_modules (1.6G).
- Would exclude: ~/Code/worktrees/feature-auth/.next (492M).
- Would exclude: ~/Code/worktrees/refactor-billing/node_modules (1.6G).
…

Would exclude 27 directories, totalling 18.4G.

--dry-run previews without changing anything. Drop the flag — and the --stats if you want it fast — to apply.

Asimov pairs each dependency directory with a sentinel config file. A folder is only excluded if its sentinel exists alongside it:

• node_modules/ → requires package.json
• vendor/ → requires composer.json or go.mod
• target/ → requires Cargo.toml or pom.xml

This means Asimov never touches a folder that just happens to share a common name. Safe to run anywhere in your home directory.

Supported ecosystems (30+ patterns)

Don't see your tool? You can teach Asimov your own directory + sentinel pairs in a couple of lines — no need to wait for a release. See Add your own patterns.

asimov [--dry-run] [--verbose] [--quiet] [--stats] [--no-read-cache] [--no-write-cache] [--help] [--version]

Asimov keeps a cache under ~/.cache/asimov/ so repeat runs are near-instant. The two flags above control it on independent axes — reading and writing:

• --no-read-cache — "rebuild." Ignores everything cached, re-scans the filesystem, and re-verifies every directory against Time Machine, then writes a fresh cache. --full-scan is an alias.
• --no-write-cache — "don't touch state." Uses the fast cache to read, but persists nothing. Handy with --dry-run.
• Both together = a fully stateless run that reads and writes nothing. --no-cache is an alias for this.

The curl and source installers set up a daily launchd job automatically. To trigger one immediately or stop the schedule:

launchctl kickstart gui/$(id -u)/com.stevegrunwell.asimov   # run now
launchctl bootout   gui/$(id -u)/com.stevegrunwell.asimov   # stop schedule

Asimov works out of the box. To customize it, drop a config file at ~/.config/asimov/config. The most useful thing you can do here is teach it dependency directories of your own.

Using a tool Asimov doesn't know about yet? Add it yourself. Each pattern is a directory sentinel pair — exactly the same mechanism the built-ins use: the directory is excluded only when the sentinel file sits right beside it, so it's safe even for common folder names.

[sentinels]
extra = .cache my-tool.toml      # exclude .cache only when my-tool.toml is its sibling
extra = generated codegen.yml    # one "extra =" line per pattern
extra = dist *.podspec           # glob sentinels work too

Want to turn a built-in off? List its exact pair under disabled:

[sentinels]
disabled = vendor Gemfile        # stop excluding Ruby's vendor/ directories

Global tool caches in your home directory (~/.cache, ~/.gradle/caches, …) are left alone by default. Opt in, and add paths of your own:

[fixed_dirs]
enabled = true                   # exclude the built-in global caches
extra   = ~/my-build-cache       # plus any paths you name (always excluded when they exist)
extra   = ~/golang/pkg/mod       # e.g. a Go module cache under a custom GOPATH

From source:

git clone https://github.com/AsimovMac/asimov.git --depth 1
cd asimov && make install

rm ~/.local/bin/asimov                                    # curl install
brew uninstall asimov                                     # Homebrew
launchctl bootout gui/$(id -u)/com.stevegrunwell.asimov   # stop schedule
make uninstall                                            # source install

See UPGRADING.md for migrating from v0.4.x or the original stevegrunwell/asimov.

Asimov was created by Steve Grunwell, who built and maintained it at stevegrunwell/asimov from 2018 through v0.3.0 — the version most people know it by. Thank you, Steve, for the years of work and for handing it on so carefully.

The project now lives at AsimovMac/asimov (the original repo, transferred — the old URL still redirects here), maintained by @django23. Releases from v0.4.0 onward add expanded ecosystem coverage, a config file, and the caching that took typical runs from ~75s to ~1–2s.

Built on the contributions of everyone who filed issues and PRs over the years. Asimov is, and stays, MIT-licensed and community-driven.

See CONTRIBUTING.md for setup and guidelines. Security issues: see SECURITY.md.

MIT