# Update

Check for updates and upgrade Ouroboros to the latest version

- Repository: https://github.com/Q00/ouroboros (6302 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Q00/ouroboros --skill update -g -a claude-code -y`
Codex: `npx skills add Q00/ouroboros --skill update -g -a codex -y`
Cursor: `npx skills add Q00/ouroboros --skill update -g -a cursor -y`
Gemini CLI: `npx skills add Q00/ouroboros --skill update -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Q00/ouroboros`

## Description

Check for updates and upgrade Ouroboros to the latest version

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /ouroboros:update

Upgrade Ouroboros without changing the installation's manager, environment, or optional-dependency profile.

```
ooo update
/ouroboros:update
```

## Instructions

The native command is the single source of truth. Run it with the active runtime's `run_shell` capability.

1. Run `ouroboros update --check`.
   - **Up to date**: report the package result together with any Codex plugin version mismatch or unknown-status warning, then stop. Do not infer that every integration is current from the package version.
   - **Update available**: ask the user (active runtime's `ask_user` capability) to choose **Update now** or **Skip**. On **Update now**, run `ouroboros update --yes`. When the user actively uses both Claude Code and Codex, run `ouroboros update --yes --runtime all` instead; it refreshes both host integrations without changing the configured execution backend. Show the command's result.

2. If the check fails but `ouroboros update --help` works, report the native error and stop. Never substitute a manual upgrade, and never infer ownership from `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 install that predates the receipt-bound updater. Fail closed: only a read-only `ouroboros --version` is allowed. Explain that the original manager, environment, and extras cannot be proven, and ask the user to rerun their exact original install command (including its `ouroboros-ai[...]` extras and custom manager root), or to do a fresh isolated install if they do not know it. Run no package upgrade, plugin refresh, or setup command on this path.

The rest: https://github.com/Q00/ouroboros/blob/HEAD/skills/update/SKILL.md