Skip to content

Personal AI, On Personal Devices

Python

feat: CLI version check against GitHub releases (daily, cached)

Jon Saad-Falconba8b994ba8dc
diff --git a/src/openjarvis/cli/__init__.py b/src/openjarvis/cli/__init__.py
index 04ba9e80..2a07ca3f 100644
--- a/src/openjarvis/cli/__init__.py
+++ b/src/openjarvis/cli/__init__.py
@@ -45,6 +45,12 @@ def cli(ctx: click.Context, verbose: bool, quiet: bool) -> None:
ctx.obj["quiet"] = quiet
setup_logging(verbose=verbose, quiet=quiet)
+ # Check for updates on interactive commands
+ if not quiet and ctx.invoked_subcommand:
+ from openjarvis.cli._version_check import check_for_updates
+
+ check_for_updates(ctx.invoked_subcommand)
+
cli.add_command(init, "init")
cli.add_command(ask, "ask")
diff --git a/src/openjarvis/cli/_version_check.py b/src/openjarvis/cli/_version_check.py
new file mode 100644
index 00000000..ef13f3f2
--- /dev/null
+++ b/src/openjarvis/cli/_version_check.py
@@ -0,0 +1,85 @@
+"""Check for newer OpenJarvis releases on GitHub."""
+
+from __future__ import annotations
+
+import json
+import logging
+import sys
+import time
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+_CACHE_PATH = Path("~/.openjarvis/version-check.json").expanduser()
+_CACHE_TTL = 86400 # 24 hours
+_GITHUB_API = "https://api.github.com/repos/open-jarvis/OpenJarvis/releases/latest"
+_CHECK_COMMANDS = {"ask", "chat", "serve"}
+
+
+def check_for_updates(command_name: str) -> None:
+ """Print a message if a newer version is available. Best-effort, never raises."""
+ if command_name not in _CHECK_COMMANDS:
+ return
+ try:
+ _do_check()
+ except Exception:
+ pass
+
+
+def _do_check() -> None:
+ import openjarvis
+
+ current = openjarvis.__version__
+ latest = _get_latest_version(current)
+ if latest is None:
+ return
+
+ from packaging.version import InvalidVersion, Version
+
+ try:
+ if Version(latest) > Version(current):
+ sys.stderr.write(
+ f"\033[33mA new version of OpenJarvis is available "
+ f"(v{current} \u2192 v{latest})\n"
+ f"Update: cd ~/OpenJarvis && git pull && uv sync\033[0m\n\n"
+ )
+ except InvalidVersion:
+ pass
+
+
+def _get_latest_version(current: str) -> str | None:
+ """Return latest version string from cache or GitHub API."""
+ try:
+ if _CACHE_PATH.exists():
+ data = json.loads(_CACHE_PATH.read_text())
+ last_check = data.get("last_check", 0)
+ if time.time() - last_check < _CACHE_TTL:
+ return data.get("latest_version")
+ except Exception:
+ pass
+
+ try:
+ import urllib.request
+
+ req = urllib.request.Request(
+ _GITHUB_API,
+ headers={"Accept": "application/vnd.github.v3+json"},
+ )
+ with urllib.request.urlopen(req, timeout=3) as resp:
+ data = json.loads(resp.read())
+ tag = data.get("tag_name", "")
+ latest = tag.lstrip("v")
+ except Exception:
+ return None
+
+ try:
+ _CACHE_PATH.parent.mkdir(parents=True, exist_ok=True)
+ _CACHE_PATH.write_text(json.dumps({
+ "last_check": time.time(),
+ "latest_version": latest,
+ "current_version": current,
+ }))
+ except Exception:
+ pass
+
+ return latest