@codebend3r/che 1.0.0

package/bin/video/validate-video-files.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""🩺 Check .mp4/.mkv files are playable by decoding a single frame with mpv.
+
+Usage:
+  validate-video-files.py --path=/path/to/media [--verbose]
+
+Options:
+  --path=DIR    Directory to scan (required)
+  --verbose     Print each file as it is checked
+  --help        Show help
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from utils import (
+    add_bool_flag,
+    build_parser,
+    info,
+    iter_files,
+    require_binary,
+    run,
+    run_cli,
+    scan_root,
+    success,
+    warning,
+)
+
+__version__ = "3.0.0"
+
+VIDEO_EXTENSIONS = ("mp4", "mkv")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser(
+        prog="validate-video-files",
+        description="🩺 Check .mp4/.mkv files are playable by decoding one frame with mpv.",
+    )
+    parser.add_argument("--path", default="", metavar="DIR", help="Directory to scan (required)")
+    add_bool_flag(parser, "--verbose", help="Print each file as it is checked")
+    info(f"Running command in {Path.cwd()}")
+    args = parser.parse_args(argv)
+
+    if not args.path:
+        warning(f"❌ Error: '{args.path}' is not a valid directory")
+        return 1
+
+    root = scan_root(args.path)
+
+    require_binary("mpv", hint="Install it using Homebrew:\n  brew install mpv")
+
+    checked = 0
+    bad: list[Path] = []
+
+    for path in iter_files(root, extensions=VIDEO_EXTENSIONS):
+        # The shell version gated this on `[[ -z "$VERBOSE" ]]`, but VERBOSE is
+        # the literal string "false" when unset, which is never empty - so the
+        # line never printed and --verbose did nothing. Wired up properly here.
+        if args.verbose:
+            info(f"Checking: {path}")
+
+        checked += 1
+        try:
+            completed = run(
+                [
+                    "mpv",
+                    # --no-config so a stale ~/.config/mpv/mpv.conf cannot emit
+                    # warnings that would be misread as playback failures.
+                    "--no-config",
+                    "--no-audio",
+                    "--vo=null",
+                    "--really-quiet",
+                    "--frames=1",
+                    str(path),
+                ],
+                check=False,
+                capture=True,
+                timeout=30,
+            )
+        except subprocess.TimeoutExpired:
+            # The shell version had no timeout, so an mpv wedged on a stalled
+            # SMB read blocked the scan forever.
+            warning(f"❌ Timed out reading: {path}")
+            bad.append(path)
+            continue
+
+        # DELIBERATE DIVERGENCE: the shell version ran mpv as a simple command
+        # under `set -e`, so the FIRST unplayable file killed the whole scan
+        # before it could even print which file it was. This records the
+        # failure and carries on. The verdict is the exit code alone; stderr
+        # noise is reported but is not by itself a failure, since --really-quiet
+        # does not suppress every warning mpv can emit.
+        if completed.returncode != 0:
+            warning(f"❌ Unplayable or error in: {path}")
+            bad.append(path)
+        elif (completed.stderr or "").strip():
+            warning(f"⚠️  Played, but mpv complained about: {path}")
+
+    print()
+    if bad:
+        warning(f"❌ {len(bad)} of {checked} file(s) failed playback.")
+        return 1
+
+    success(f"✅ All {checked} file(s) played back cleanly.")
+    return 0
+
+
+if __name__ == "__main__":
+    run_cli(main)

package/bin/video/video-list.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""🎬 List .mp4/.mkv files under a path with human-readable sizes.
+
+Usage:
+  video-list.py --path=/dir [--recursive] [--sort=alpha|fileSizeAsc|fileSizeDesc]
+                [--with-folder]
+
+Options:
+  --path=DIR      Directory to scan (required)
+  --recursive     Recurse into subdirectories (default: top level only)
+  --sort=METHOD   alpha (default), fileSizeAsc, or fileSizeDesc
+  --with-folder   Prefix each name with its containing folder
+  --help          Show help
+"""
+
+from __future__ import annotations
+
+import locale
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from utils import (
+    CYAN,
+    GREEN,
+    NC,
+    YELLOW,
+    add_bool_flag,
+    build_parser,
+    format_bytes,
+    info,
+    iter_files,
+    log,
+    note,
+    run_cli,
+    scan_root,
+    warning,
+)
+
+__version__ = "3.0.0"
+
+VIDEO_EXTENSIONS = ("mp4", "mkv")
+SORT_METHODS = ("alpha", "fileSizeAsc", "fileSizeDesc")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser(
+        prog="video-list",
+        description="🎬 List .mp4/.mkv files under a path with human-readable sizes.",
+    )
+    parser.add_argument("--path", default="", metavar="DIR", help="Directory to scan (required)")
+    add_bool_flag(parser, "--recursive", help="Recurse into subdirectories")
+    add_bool_flag(parser, "--with-folder", dest="with_folder", help="Prefix with folder name")
+    parser.add_argument(
+        "--sort",
+        default="alpha",
+        choices=SORT_METHODS,
+        metavar="METHOD",
+        help="alpha (default), fileSizeAsc, or fileSizeDesc",
+    )
+    info(f"Running command in {Path.cwd()}")
+    args = parser.parse_args(argv)
+
+    note(f"Scanning: {args.path}")
+    note(f"Recursive: {str(args.recursive).lower()}")
+    note(f"Sort method: {args.sort}")
+    note(f"With folder: {str(args.with_folder).lower()}")
+    note("----------------------------------------------------")
+
+    if not args.path:
+        warning("❌ --path is required")
+        return 1
+
+    # Replaces the shell version's `find` error on a missing path with a
+    # styled message; the exit code is unchanged.
+    root = scan_root(args.path)
+
+    entries: list[tuple[int, Path]] = []
+    for path in iter_files(
+        root,
+        extensions=VIDEO_EXTENSIONS,
+        recursive=args.recursive,
+        skip_hidden=True,
+    ):
+        try:
+            entries.append((path.stat().st_size, path))
+        except OSError:
+            continue
+
+    if args.sort == "fileSizeAsc":
+        entries.sort(key=lambda item: (item[0], str(item[1])))
+    elif args.sort == "fileSizeDesc":
+        # `sort -nr` reverses its last-resort full-line tiebreak too, so equal
+        # sizes come out in DESCENDING path order. Reverse both key fields.
+        entries.sort(key=lambda item: (item[0], str(item[1])), reverse=True)
+    else:
+        # `sort -k2` collates under LC_COLLATE, which is case-insensitive at
+        # the primary level. strxfrm reproduces that; a plain codepoint sort
+        # would put every capitalised name first.
+        locale.setlocale(locale.LC_COLLATE, "")
+        entries.sort(key=lambda item: locale.strxfrm(str(item[1])))
+
+    for size, path in entries:
+        size_human = format_bytes(size)
+        if args.with_folder:
+            # `basename $(dirname ./x.mkv)` is ".", but pathlib collapses the
+            # "." away and leaves parent.name empty - which would render as a
+            # bare leading slash and read like an absolute path.
+            folder = path.parent.name or path.parent.as_posix()
+            display = f"{CYAN}{folder}{NC}/{GREEN}{path.name}{NC} {YELLOW}[{size_human}]{NC}"
+        else:
+            display = f"{GREEN}{path.name}{NC} {YELLOW}[{size_human}]{NC}"
+        log(display)
+
+    return 0
+
+
+if __name__ == "__main__":
+    run_cli(main)

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@codebend3r/che",
+  "version": "1.0.0",
+  "description": "Helper scripts shared across machines, called by name from your shell and browsable through one menu",
+  "keywords": [
+    "cli",
+    "shell",
+    "zsh",
+    "bash",
+    "fish",
+    "python",
+    "scripts",
+    "menu",
+    "macos"
+  ],
+  "homepage": "https://github.com/codebend3r/che#readme",
+  "bugs": "https://github.com/codebend3r/che/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codebend3r/che.git"
+  },
+  "license": "MIT",
+  "author": "CJ Rivas (https://github.com/codebend3r)",
+  "bin": {
+    "che": "bin/che.py"
+  },
+  "files": [
+    "bin/",
+    "shell/",
+    "!bin/version-bump.py",
+    "!**/__pycache__/",
+    "!**/*.pyc"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "uv run --no-project --with-requirements requirements-dev.txt -- pytest",
+    "ci": "run-s lint format syntax executable shebang generated test",
+    "lint": "uv run --no-project --with-requirements requirements-dev.txt -- ruff check bin test",
+    "format": "uv run --no-project --with-requirements requirements-dev.txt -- ruff format --check bin test",
+    "syntax": "find bin test -type f -name '*.py' -print0 | xargs -0 -n1 python3 -m py_compile",
+    "executable": "find bin -type f -name '*.py' ! -perm -u+x -print0 | xargs -0 awk 'FNR==1 && /^#!/{print \"Has a shebang but is not executable: \" FILENAME; ec=1} END{exit ec+0}'",
+    "shebang": "find bin -type f -name '*.py' -perm -u+x -print0 | xargs -0 awk 'FNR==1 && !/^#!/{print \"Executable but has no shebang: \" FILENAME; ec=1} END{exit ec+0}'",
+    "generate": "python3 bin/install.py --generate",
+    "generated": "python3 bin/install.py --check",
+    "version": "bun run generate && git add shell .zshrc README.md",
+    "prepublishOnly": "bun run ci"
+  },
+  "packageManager": "bun@1.3.14",
+  "devDependencies": {
+    "npm-run-all2": "9.0.1"
+  }
+}

package/shell/che.bash

@@ -0,0 +1,382 @@
+# che 1.0.0 - generated file, do not edit.
+#
+# Generated from bin/commands.py by `che install`.
+# To change a wrapper, edit that manifest and run `che install` again.
+#
+# Source this file (or let the `che install` block in your rc file do it):
+#
+#     . ~/Developer/git/che/shell/che.bash
+#
+# Every wrapper is a shell function, so `type <name>` shows what it runs and
+# `che doctor` can tell you when something it needs is missing.
+
+# CHE_HOME is normally exported by the installed rc block. Fall back to this
+# file's own location so a bare `source` of it also works.
+if [ -z "${CHE_HOME:-}" ]; then
+  CHE_HOME="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
+
+# Exported, not just set: every wrapper expands "$CHE_BIN", and a shell that
+# replays the *functions* without re-reading this file - a `typeset -f` dump, an
+# environment snapshot, any tool that rebuilds a shell from its exported
+# environment - keeps the functions and drops a plain variable, leaving the
+# wrappers to run "/che.py". CHE_HOME comes in exported by the rc block; this
+# keeps everything derived from it exported too.
+export CHE_BIN="${CHE_HOME}/bin"
+
+# Any python3 on PATH by default. `che install` records the interpreter it
+# verified (3.12+) in the rc block, which wins over this.
+: "${CHE_PYTHON:=python3}"
+export CHE_PYTHON
+
+# Legacy name from the hand-maintained wrappers, kept so an older snippet in
+# ~/.zshrc that still refers to it keeps resolving.
+export SHELL_FUNCTIONS_BIN="${CHE_BIN}"
+
+# Play the completion sound for a wrapper, then return the status it was given.
+#
+# playsound-N is defined outside this repo. Every wrapper used to call it
+# unconditionally, which printed "command not found" on a machine that never
+# had it; here a missing playsound is simply skipped. Set CHE_SOUNDS=0 to
+# silence them all.
+che_notify() {
+  if [ "${CHE_SOUNDS:-1}" = "1" ] && command -v "playsound-$1" >/dev/null 2>&1; then
+    "playsound-$1" >/dev/null 2>&1
+  fi
+  return "${2:-0}"
+}
+
+# The dispatcher. `che` with no arguments opens the interactive menu.
+che() {
+  if [ "$#" -eq 0 ]; then
+    "$CHE_PYTHON" "$CHE_BIN/che.py"
+  else
+    "$CHE_PYTHON" "$CHE_BIN/che.py" "$@"
+    che_notify 7 $?
+  fi
+}
+
+# Same trap as zsh: with expand_aliases on (every interactive bash), an alias
+# sharing a name with a wrapper below turns its definition into a syntax error
+# and the rest of this file never loads. Stash, define, restore - so the user's
+# alias keeps winning at the prompt and `\name` reaches the wrapper.
+_che_stashed_aliases=()
+
+_che_stash_aliases() {
+  local name
+  for name in "$@"; do
+    if alias "$name" >/dev/null 2>&1; then
+      _che_stashed_aliases+=("$(alias "$name")")
+      unalias "$name"
+    fi
+  done
+}
+
+_che_restore_aliases() {
+  local entry
+  for entry in "${_che_stashed_aliases[@]}"; do
+    eval "$entry"
+  done
+  _che_stashed_aliases=()
+}
+
+_che_stash_aliases che all-actions all-actions-watch checkout-my-branches \
+  clean-stale-branches clean-stale-branches-dr prune-worktrees \
+  prune-worktrees-dr sync-all-branches sync-all-branches-dr \
+  update-from-origin update-local-branches show-codecs fix-codecs \
+  fix-codecs-dr find-video-mkv-issues validate-video-files \
+  scan-videos-audio-language remove-metadata rename-video-file \
+  delete-duplicate-videos delete-duplicate-videos-dr video-list \
+  detect-green-magenta-videos find-movie-by-year largest-tv-shows \
+  delete-by-ext delete-by-ext-dr delete-empty-folders \
+  delete-empty-folders-dr delete-smb-files delete-smb-files-dr \
+  files-under-size files-under-size-dr find-largest-files make-alpha-dir \
+  compress-folders list-permission mount-all-drives eject-all-drives \
+  eject-all-drives-dr ping-nas update-brew update-brew-dr btop
+
+# --------------------------------------------------------------------------
+# Git - Branch hygiene, worktrees and GitHub Actions
+# --------------------------------------------------------------------------
+
+# GitHub Actions status for every open PR you authored
+all-actions() {
+  "$CHE_PYTHON" "$CHE_BIN/git/all-actions.py" "$@"
+}
+
+# Same as all-actions, refreshed on an interval
+all-actions-watch() {
+  "$CHE_PYTHON" "$CHE_BIN/git/all-actions.py" --watch "$@"
+}
+
+# Check out recent remote branches you authored that aren't local yet
+checkout-my-branches() {
+  "$CHE_PYTHON" "$CHE_BIN/git/checkout-my-branches.py" "$@"
+  che_notify 7 $?
+}
+
+# Delete local branches whose upstream is gone
+clean-stale-branches() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/git/clean-stale-branches.py" "$@"
+  che_notify 4 $?
+}
+
+# Delete local branches whose upstream is gone (preview only)
+clean-stale-branches-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/git/clean-stale-branches.py" "$@"
+  che_notify 7 $?
+}
+
+# Remove every linked worktree, then prune stale admin records
+prune-worktrees() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/git/prune-worktrees.py" "$@"
+  che_notify 4 $?
+}
+
+# Remove every linked worktree, then prune stale admin records (preview only)
+prune-worktrees-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/git/prune-worktrees.py" "$@"
+  che_notify 7 $?
+}
+
+# Push every worktree, collapse the pushed ones, then tidy branches
+sync-all-branches() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/git/sync-all-branches.py" "$@"
+  che_notify 7 $?
+}
+
+# Push every worktree, collapse the pushed ones, then tidy branches (preview only)
+sync-all-branches-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/git/sync-all-branches.py" "$@"
+  che_notify 7 $?
+}
+
+# Same as sync-all-branches but never pushes: fetch, collapse, rebase
+update-from-origin() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/git/sync-all-branches.py" --no-push "$@"
+  che_notify 7 $?
+}
+
+# Rebase every local branch that has an upstream onto origin
+update-local-branches() {
+  "$CHE_PYTHON" "$CHE_BIN/git/update-local-branches.py" "$@"
+  che_notify 5 $?
+}
+
+# --------------------------------------------------------------------------
+# Video - Codecs, renaming, dedupe and metadata
+# --------------------------------------------------------------------------
+
+# Report media files outside the Direct Play codec/container set
+show-codecs() {
+  "$CHE_PYTHON" "$CHE_BIN/video/show-codecs.py" "$@"
+  che_notify 6 $?
+}
+
+# Re-encode media to h265/aac mp4 so it Direct Plays
+fix-codecs() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/video/fix-codecs.py" "$@"
+  che_notify 7 $?
+}
+
+# Re-encode media to h265/aac mp4 so it Direct Plays (preview only)
+fix-codecs-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/video/fix-codecs.py" "$@"
+  che_notify 7 $?
+}
+
+# Scan MKV files and estimate Plex direct-play compatibility
+find-video-mkv-issues() {
+  "$CHE_PYTHON" "$CHE_BIN/video/find-video-mkv-issues.py" "$@"
+  che_notify 4 $?
+}
+
+# Check .mp4/.mkv files decode by playing one frame with mpv
+validate-video-files() {
+  "$CHE_PYTHON" "$CHE_BIN/video/validate-video-files.py" "$@"
+  che_notify 2 $?
+}
+
+# Print the audio language tags of every video under a path
+scan-videos-audio-language() {
+  "$CHE_PYTHON" "$CHE_BIN/video/scan-videos-audio-language.py" "$@"
+  che_notify 3 $?
+}
+
+# Strip all metadata from video files recursively
+remove-metadata() {
+  "$CHE_PYTHON" "$CHE_BIN/video/remove-metadata.py" "$@"
+  che_notify 4 $?
+}
+
+# Title-case video filenames (and optionally their folders)
+rename-video-file() {
+  "$CHE_PYTHON" "$CHE_BIN/video/rename-video-file.py" "$@"
+  che_notify 5 $?
+}
+
+# Delete duplicate MKV/MP4 files under a root directory
+delete-duplicate-videos() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/video/delete-duplicate-videos.py" "$@"
+  che_notify 6 $?
+}
+
+# Delete duplicate MKV/MP4 files under a root directory (preview only)
+delete-duplicate-videos-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/video/delete-duplicate-videos.py" "$@"
+  che_notify 6 $?
+}
+
+# List .mp4/.mkv files under a path with human-readable sizes
+video-list() {
+  "$CHE_PYTHON" "$CHE_BIN/video/video-list.py" "$@"
+  che_notify 5 $?
+}
+
+# Detect videos with the green/magenta chroma artifact
+detect-green-magenta-videos() {
+  "$CHE_PYTHON" "$CHE_BIN/video/detect-green-magenta-videos.py" "$@"
+  che_notify 3 $?
+}
+
+# Find movie folders whose name ends with "(YYYY)"
+find-movie-by-year() {
+  "$CHE_PYTHON" "$CHE_BIN/video/find-movie-by-year.py" "$@"
+  che_notify 2 $?
+}
+
+# Rank TV show folders in a library by total size on disk
+largest-tv-shows() {
+  "$CHE_PYTHON" "$CHE_BIN/video/largest-tv-shows.py" "$@"
+  che_notify 2 $?
+}
+
+# --------------------------------------------------------------------------
+# Files - Delete, compress and inspect by size or extension
+# --------------------------------------------------------------------------
+
+# Delete files under a path matching a set of extensions
+delete-by-ext() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/files/delete-by-ext.py" "$@"
+  che_notify 6 $?
+}
+
+# Delete files under a path matching a set of extensions (preview only)
+delete-by-ext-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/files/delete-by-ext.py" "$@"
+  che_notify 7 $?
+}
+
+# Delete truly-empty directories under a path, cascading upwards
+delete-empty-folders() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/files/delete-empty-folders.py" "$@"
+  che_notify 6 $?
+}
+
+# Delete truly-empty directories under a path, cascading upwards (preview only)
+delete-empty-folders-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/files/delete-empty-folders.py" "$@"
+  che_notify 7 $?
+}
+
+# Delete .smbdelete* files left behind by an SMB share
+delete-smb-files() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/files/delete-smb-files.py" "$@"
+  che_notify 6 $?
+}
+
+# Delete .smbdelete* files left behind by an SMB share (preview only)
+delete-smb-files-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/files/delete-smb-files.py" "$@"
+  che_notify 7 $?
+}
+
+# Find video files at or under a size threshold
+files-under-size() {
+  DRY_RUN=false "$CHE_PYTHON" "$CHE_BIN/files/files-under-size.py" "$@"
+  che_notify 4 $?
+}
+
+# Find video files at or under a size threshold (preview only)
+files-under-size-dr() {
+  DRY_RUN=true "$CHE_PYTHON" "$CHE_BIN/files/files-under-size.py" "$@"
+  che_notify 7 $?
+}
+
+# List the largest files under a path, biggest first
+find-largest-files() {
+  "$CHE_PYTHON" "$CHE_BIN/files/find-largest-files.py" "$@"
+  che_notify 2 $?
+}
+
+# Create '#' and A-Z bucket folders under a parent directory
+make-alpha-dir() {
+  "$CHE_PYTHON" "$CHE_BIN/files/make-alpha-dir.py" "$@"
+  che_notify 4 $?
+}
+
+# Zip every immediate subfolder of a path at max compression
+compress-folders() {
+  "$CHE_PYTHON" "$CHE_BIN/files/compress-folders.py" "$@"
+  che_notify 7 $?
+}
+
+# Show ownership and mode of a volume under /Volumes
+list-permission() {
+  command ls -ld "/Volumes/$1"
+  che_notify 7 $?
+}
+
+# --------------------------------------------------------------------------
+# Drives - Mount, eject and keep-alive for the NAS volumes
+# --------------------------------------------------------------------------
+
+# Mount all NAS drives over SMB via AppleScript
+mount-all-drives() {
+  "$CHE_PYTHON" "$CHE_BIN/drives/mount-all-drives.py" "$@"
+  che_notify 7 $?
+}
+
+# Eject all NAS volumes from /Volumes
+eject-all-drives() {
+  "$CHE_PYTHON" "$CHE_BIN/drives/eject-all-drives.py" "$@"
+  che_notify 7 $?
+}
+
+# Eject all NAS volumes from /Volumes (preview only)
+eject-all-drives-dr() {
+  "$CHE_PYTHON" "$CHE_BIN/drives/eject-all-drives.py" --dry-run "$@"
+  che_notify 7 $?
+}
+
+# Keep-alive pinger that remounts a NAS drive that dropped off
+ping-nas() {
+  "$CHE_PYTHON" "$CHE_BIN/drives/ping-nas.py" "$@"
+}
+
+# --------------------------------------------------------------------------
+# System - Homebrew, monitoring and the machine itself
+# --------------------------------------------------------------------------
+
+# Update Homebrew, upgrade formulae and casks, then clean up
+update-brew() {
+  "$CHE_PYTHON" "$CHE_BIN/system/update-brew.py" "$@"
+  che_notify 7 $?
+}
+
+# Update Homebrew, upgrade formulae and casks, then clean up (preview only)
+update-brew-dr() {
+  "$CHE_PYTHON" "$CHE_BIN/system/update-brew.py" --dry-run "$@"
+  che_notify 7 $?
+}
+
+# Launch btop with a gruvbox theme matching the macOS appearance
+btop() {
+  "$CHE_PYTHON" "$CHE_BIN/system/btop-launch.py" "$@"
+}
+
+_che_restore_aliases
+
+# Completions, when this is bash and the completion builtin is available.
+if [ -n "${BASH_VERSION:-}" ] && [ -r "${CHE_HOME}/shell/completions/che.bash" ]; then
+  . "${CHE_HOME}/shell/completions/che.bash"
+fi