update

name	update
description	Check for updates and upgrade Ouroboros to the latest version

/ouroboros:update

Check for updates and upgrade Ouroboros without changing the installation's manager, environment, or optional-dependency profile.

Usage

ooo update
/ouroboros:update

Trigger keywords: "ooo update", "update ouroboros", "upgrade ouroboros"

Instructions

When the user invokes this skill:

1. Use the native command as the single source of truth:

   ouroboros update --check
   

   • If it reports up to date, report that result and stop.

   • If it reports an update available, ask the user to choose Update now or Skip.

   • If the user chooses Update now, run:

     ouroboros update --yes
     

     When the user actively uses both Claude Code and Codex, refresh both host integrations without changing the configured execution backend:

     ouroboros update --yes --runtime all
     

   Show the command's result. The native updater binds the package upgrade and post-update setup to one receipt-backed installation identity: manager, environment, recorded profile, and environment-local console script.

2. If the check exits unsuccessfully but ouroboros update --help works, report the native error and stop. Do not replace it with a manual updater. In particular, do not infer ownership from global uv tool list, pipx list, PATH order, directory names, or the active agent runtime.

3. If ouroboros update --help does not work, this is a legacy installation that predates the receipt-bound updater. Fail closed:

   • A read-only ouroboros --version check is allowed.
   • Explain that the old skill cannot prove the original manager, environment, and extras/profile, so it will not mutate the installation.
   • Ask the user to rerun the exact original install command (including its ouroboros-ai[...] extras and custom manager root) to reach a version with the native updater.
   • If the user does not know that identity, recommend a fresh isolated install rather than guessing.
   • Do not run package upgrades, plugin refreshes, or setup commands from this legacy path.

4. After a successful update, relay the runtime-specific restart guidance from the native command. If project instruction content also needs regeneration, suggest ooo setup; do not edit project instruction files as part of the package update.

Safety contract

• PyPI is the version source of truth; fully yanked releases are excluded.
• uv and pipx upgrades replay the running environment's local receipt, preserving base, [tui], [mcp,tui], [claude,tui], [all], and other recorded profiles.
• The Claude SDK and MCP 2 profiles are never combined or substituted.
• Missing or ambiguous installation identity is a non-mutating error.
• Automatic runtime refresh preserves the configured backend and the existing OpenCode plugin/subprocess topology instead of inferring a replacement from PATH.
• Runtime executable identity follows the supported environment override, then the persisted orchestrator.*_cli_path, then PATH. The chosen exact executable is validated and reused for plugin/setup refresh so a stale PATH binary cannot replace an operator-selected runtime.
• --runtime all refreshes the Claude and Codex plugin integrations plus installed runtime artifacts without changing the configured execution backend. Active Codex sessions still need a restart because Codex does not currently retain an in-use plugin generation; Claude may use /reload-plugins or restart.
• ouroboros update supports --check, --yes, --dry-run, --prerelease, and --runtime; see ouroboros update --help.

RFC #1392 State Breadcrumb Footer

Your final response MUST end with exactly one breadcrumb footer line:

◆ <current state> → next: <recommended action>

Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.