reveil

réveil (French) — awakening, alarm clock.

A quiet, elegant master switch that wakes your curated arsenal of tools.

reveil

One command. Every package manager you care about, updated in parallel. Framed output you can actually read. Version deltas so you know what changed. A summary table that tells the whole story at a glance.

The ritual

▌ Preparing the arsenal
  brew            4.2.0
  rustup          1.27.1

▌ Awakening in parallel

▌ Instrument output

┌─[ brew ]
│ ==> Upgrading 3 outdated formulae...
│ ...
└─

▌ Summary
  TOOL          VERSION                STATUS
  ──────────────────────────────────────────
  brew          4.2.0 → 4.3.0          ↑ updated
  rustup        1.27.1                 = current

  1 ↑ updated  ·  1 = current

Quick start

Install it once:

npm install -g @filecrop/reveil

Then build your arsenal and awaken it:

reveil detect     # scan this machine and add the tools it finds
reveil            # update everything in parallel

That's it. Two commands and your environment is in sync.

Prefer not to install globally? Run it on demand:

npx @filecrop/reveil detect
npx @filecrop/reveil

Published as @filecrop/reveil; the installed command is reveil. Requires Node.js 18 or newer.

Usage

reveil                    # Awaken the arsenal — run all enabled jobs
reveil run [job…]         # Run all jobs, or only the named ones
reveil detect             # Scan this machine for package managers
reveil list               # Show the arsenal and last-run state
reveil add                # Add a job to the arsenal interactively
reveil remove <job>       # Remove a job from the arsenal
reveil schedule           # Install an OS-native recurring cadence
reveil unschedule         # Remove the recurring cadence
reveil daemon             # Run a foreground in-memory scheduler
reveil config             # Print the config file path

Configuration

Config lives at ~/Library/Application Support/reveil/config.json (macOS) or ~/.config/reveil/config.json (Linux). It's JSON — no special syntax, no lock-in, syncs cleanly across machines.

{
  "version": 1,
  "jobs": [
    {
      "name": "brew",
      "run": {
        "darwin": "brew upgrade",
        "linux": "brew upgrade"
      },
      "version": "brew --version",
      "size": "/opt/homebrew",
      "enabled": true
    },
    {
      "name": "rustup",
      "run": "rustup update",
      "version": "rustup --version",
      "enabled": true
    }
  ],
  "schedule": {
    "cadence": "daily",
    "time": "09:00"
  }
}

run can be a plain string (all platforms) or a { darwin, linux, win32 } object. Jobs without a command for the current platform are silently skipped — so one config file works everywhere.

version and size are optional. Size tracking uses du -skL and is Unix-only; the column is omitted on Windows.

Scheduling

reveil schedule      # interactive — sets cadence + time, installs OS-native timer
reveil unschedule    # removes it

On macOS this installs a launchd plist in ~/Library/LaunchAgents. The timer survives reboots and costs nothing when idle. Linux (#1) and Windows (#2) scheduling backends are planned against the same Scheduler interface. Contributions welcome.

For development or when you want explicit foreground control:

reveil daemon        # non-persistent foreground scheduler; stops when you close the terminal

Platform support

| Feature | macOS | Linux | Windows | |-----------------|-------|-------|---------| | Run jobs | ✓ | ✓ | ✓ | | Version deltas | ✓ | ✓ | ✓ | | Size deltas | ✓ | ✓ | — | | OS scheduling | ✓ | stub | stub |

Philosophy

The world has enough noisy CLIs. reveil is the antithesis of command-line fatigue: structured, deliberate, understated. It doesn't shout when things go wrong. It doesn't celebrate when things go right. It simply synchronizes your environment and gets out of the way.

Configure once. Awaken daily.

License

MIT © jamubc