Files
Willie 93c12557bd docs: prepare the 0.30.5 update controls release
Refresh all README release notices and route agents to the new updates command. Clarify that desktop policy controls require a compatible App release; the CLI upgrade alone cannot change older desktop builds.

The website builds for all five locales, context validation and skill validation pass. The documentation diff passed five local review passes.
2026-11-11 13:40:45 +08:00

3.3 KiB

sidebar_position
sidebar_position
4

updates

Control automatic version checks and update notifications for the CLI, built-in skill, web dashboard and compatible desktop app releases. This is a global preference, including in project mode. Desktop controls require an app release that includes skillshare-app#126. Upgrading the CLI alone does not disable automatic checks in older desktop builds.

Usage

skillshare updates             # Show the effective preference
skillshare updates off         # Disable automatic checks and notifications
skillshare updates on          # Restore automatic checks
skillshare updates check       # Explicitly check the CLI version now
skillshare updates --json      # Read the saved and effective preference
Option Description
on / off Save the global preference
check Check the CLI version now, bypassing the preference and version cache
--json Output JSON
--help, -h Show help

The JSON preference has enabled (effective), configured (saved, or the default), and envOverride fields. Setting a preference does not change an environment override.

Configuration

Automatic checks are enabled by default. To opt out, set this in the global config.yaml:

updates:
  auto_check: false

Or override it for a process and its children:

SKILLSHARE_AUTO_UPDATE_CHECK=false skillshare status

Precedence: environment variable > config.yaml > true. Accepted values are true/false, 1/0, t/f and their Go boolean case variants. Empty or invalid values are ignored. Environment overrides are never written back.

With checks disabled, ordinary commands and doctor do not check release versions or show update notifications, even when an older check cached a newer release. The web UI does not automatically show an update dialog or version-status badges. An already-open dashboard refreshes the local preference every five seconds (without checking releases), so turning checks off from the CLI or app also hides existing prompts.

In Web Settings → General and compatible desktop Settings → Updates, the automatic-check switch writes the same global preference. An environment override locks the switch. The desktop app refreshes external preference changes within a minute and hides version badges as well as native version notifications. Its CLI must support updates to read/write the saved preference; older CLIs keep the existing default and require a CLI upgrade to enable the switch. Environment opt-out still works.

Manual checks and upgrades

skillshare updates check, Web Settings' Check for updates, desktop Check, and upgrade remain available. Manual results are shown where requested, without re-enabling automatic notifications. Web Settings offers Update now after an explicit check finds an update. Cached Doctor update notices are hidden too; JSON checks mark these with update_available: true so unrelated diagnostic warnings remain visible. Desktop skill, agent, plugin and repository source checks are not release-version checks and are unchanged.

See environment variables.