Skip to content

UPGRADING.md

Latest commit

 

History

History
157 lines (109 loc) · 4.83 KB

UPGRADING.md

File metadata and controls

157 lines (109 loc) · 4.83 KB
Raw

Upgrading Asimov

To v0.10.0 from v0.3.0 (the original stevegrunwell/asimov)

Most people upgrading are coming from 0.3.0, the version Homebrew shipped for years. It upgrades cleanly, but three leftovers can outlive it. Work through this in order.

Before you start: don't run asimov to check your version. v0.3.0 parses no arguments at all — it ignores --version, --help, and every subcommand, and goes straight to scanning and writing Time Machine exclusions. Read the version out of the file instead:

grep -m1 -E '@version|ASIMOV_VERSION=' "$(command -v asimov)"

1. Stop the schedule before you uninstall

Uninstalling first leaves the LaunchAgent behind with nothing to run:

brew services stop asimov
launchctl bootout gui/$(id -u)/homebrew.mxcl.asimov 2>/dev/null
rm -f ~/Library/LaunchAgents/homebrew.mxcl.asimov.plist

2. Replace the binary

brew uninstall asimov
brew install asimov

If brew uninstall reports Permission denied @ apply2files, the old cellar files are owned by another user — Homebrew prints the sudo command to force it, and that is safe here.

3. Clear the old cache

v0.10.0 keeps state in ~/.cache/asimov/. If anything ever ran Asimov as root, those files are root-owned and unreadable by you:

rm -rf ~/.cache/asimov

v0.10.0 and earlier crashed outright on this with a bare Permission denied. Current versions warn and carry on, but clearing it is still the fix.

4. Check the result

doctor exists only in current versions, so it comes last — there is nothing to run before the new binary is in place:

asimov doctor

It reports a shadowed binary, a leftover schedule, an unreadable cache, and a bad config, and exits non-zero if it finds any. If it prints usage errors or starts a scan instead, an old binary is still first on your PATH — doctor names the one it found.

One thing that isn't broken

Asimov is a one-shot scan, not a daemon. After brew services start asimov, ps aux | grep asimov finding nothing is expected: it scans, excludes, and exits. To confirm it is actually scheduled, use asimov doctor.

To v0.10.0 (from the django23/asimov fork)

0.10.0 folds the fork's work (v0.4.0–v0.8.0, plus a v0.9.0-beta round) back into the original project, now homed at AsimovMac/asimov (transferred from stevegrunwell/asimov, which now redirects there). It also reverts the LaunchAgent label from com.django23.asimov back to the original com.stevegrunwell.asimov.

The installers remove the old com.django23.asimov agent for you. If you want to migrate by hand, unload the fork's agent first so you don't end up with two daily jobs:

launchctl bootout gui/$(id -u)/com.django23.asimov 2>/dev/null
rm ~/Library/LaunchAgents/com.django23.asimov.plist 2>/dev/null

Then install v0.10.0:

curl -fsSL https://raw.githubusercontent.com/AsimovMac/asimov/main/scripts/install-remote.sh | bash

Your ~/.config/asimov/config and ~/.cache/asimov/ are unaffected.

Upgrading to Asimov v0.5.0

From v0.4.x (this fork)

v0.5.0 is a breaking release. Here's what changed:

1. Fixed directories are now opt-in

Global cache directories (~/.cache, ~/.gradle/caches, etc.) are no longer excluded by default. To restore the previous behavior, create a config file:

mkdir -p ~/.config/asimov
cat > ~/.config/asimov/config << 'EOF'
[fixed_dirs]
enabled = true
EOF

2. LaunchAgent label changed

The plist label changed from com.stevegrunwell.asimov to com.django23.asimov. If upgrading a manual install, unload the old agent first:

launchctl unload ~/Library/LaunchAgents/com.stevegrunwell.asimov.plist 2>/dev/null
make install

Homebrew users: brew upgrade handles this automatically.

3. Output changes

  • "Already excluded, skipping" messages are now hidden by default (use --verbose to see them).
  • New --quiet flag suppresses all output except errors.
  • ANSI colors are disabled when stdout is not a terminal (e.g. launchd logs).

From stevegrunwell/asimov (original)

Welcome! This fork adds config file support, 30+ new ecosystem patterns, --dry-run, --verbose, --quiet, performance improvements, and daily scheduling via launchd.

Step 1: Remove the original

brew uninstall asimov 2>/dev/null
# or, if installed manually:
launchctl unload ~/Library/LaunchAgents/com.stevegrunwell.asimov.plist 2>/dev/null
rm /usr/local/bin/asimov

Step 2: Install this fork

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

Step 3: (Optional) Enable global cache exclusions

The original asimov did not have this feature. To enable it:

mkdir -p ~/.config/asimov
cat > ~/.config/asimov/config << 'EOF'
[fixed_dirs]
enabled = true
EOF