Files
skillshare/website/docs/reference/commands/upgrade.md
T
Willie 4b89e81fdd docs: cover the project MCP row, the piOptions box and upgrade progress
The dashboard pages still described the project row without the Agent logos
and the Match the project action, the ui page did not mention where piOptions
is edited, and upgrade did not say the download now reports its progress.

Refs #289
2026-09-22 02:40:02 +08:00

3.1 KiB

sidebar_position
sidebar_position
3

upgrade

Upgrade the skillshare CLI binary and/or the built-in skillshare skill.

skillshare upgrade              # Upgrade both CLI and skill
skillshare upgrade --cli        # CLI only
skillshare upgrade --skill      # Skill only

When to Use

  • A new version of the skillshare CLI is available
  • The built-in skillshare skill needs updating
  • After doctor reports an available update

upgrade demo

What Happens

flowchart TD
    TITLE["skillshare upgrade"]
    CLI["1. Upgrade CLI binary"]
    SKILL["2. Upgrade built-in skill"]
    TITLE --> CLI --> SKILL

Options

Flag Description
--cli Upgrade CLI only
--skill Upgrade skill only (prompts if not installed)
--force, -f Skip confirmation prompts
--dry-run, -n Preview without making changes
--help, -h Show help

Homebrew Users

If you installed via Homebrew, skillshare upgrade automatically delegates to brew upgrade:

skillshare upgrade
# → brew update && brew upgrade skillshare

You can also use Homebrew directly:

brew upgrade skillshare

Examples

# Standard upgrade (both CLI and skill)
skillshare upgrade

# Preview what would be upgraded
skillshare upgrade --dry-run

# Force upgrade without prompts
skillshare upgrade --force

# Upgrade only the CLI binary
skillshare upgrade --cli

# Upgrade only the skillshare skill
skillshare upgrade --skill

After Upgrading

If you upgraded the skill, run skillshare sync to distribute it:

skillshare upgrade --skill
skillshare sync  # Distribute to all targets

What Gets Upgraded

CLI Binary

The skillshare executable itself. Downloads from GitHub releases.

In a terminal, the download shows how much has arrived, so a slow connection does not look like a hang. The Web UI assets below show the same.

Downloading v0.21.4...  3.2 MB / 9.1 MB

If the binary is in a protected directory (e.g., /usr/local/bin), skillshare automatically re-runs the upgrade with sudo — no manual prefix needed.

When there is no terminal to ask for a password on (the dashboard's Update now button, CI), the upgrade stops right away and tells you to run sudo skillshare upgrade in a terminal instead of waiting for input. Cached sudo credentials and NOPASSWD setups still upgrade without a prompt.

Web UI Assets

After upgrading, skillshare pre-downloads the Web UI frontend assets for the new version. These are cached at ~/.cache/skillshare/ui/<version>/ and served when you run skillshare ui.

If the pre-download fails (e.g. network issues), the assets will be downloaded on the next skillshare ui launch instead.

skillshare Skill

The built-in skillshare skill that adds the /skillshare command to AI CLIs. Located at:

~/.config/skillshare/skills/skillshare/SKILL.md

See Also

  • update — Update other skills and repos
  • status — Check current versions
  • doctor — Diagnose issues