Skip to content
Get packs

OpenRig Upgrade Helper

Guides an agent through a careful OpenRig CLI/daemon upgrade without disrupting live agent seats

Source Download skill
Repository
mvschwarz/openrig
Stars
8,553
Licence
Apache-2.0
Files
4 files

What it does

This skill teaches an AI agent a step-by-step, observe-after-every-change method for upgrading OpenRig, a tool that runs multiple AI agent sessions (called seats) on a host. Instead of running one blind upgrade command, the agent inspects the live system, makes one bounded change, checks the result, and then decides what to do next. It also ships three small helper scripts: one reports current version, daemon and plugin status as JSON; one copies the SQLite database to a new backup file and checks its integrity; and one compares managed plugin files so only safe updates are applied without overwriting local edits.

Great for

  • Operators maintaining a running OpenRig host who need to upgrade without losing live agent sessions
  • Developers testing OpenRig upgrades on a recovery-friendly build VM before touching production

Skip it if

  • Hosts where you have no backup or cannot tolerate downtime risk, because the skill relies on the agent to make the right calls and mistakes can still break a running system
  • Anyone wanting a one-click upgrade, since the skill deliberately has no end-to-end upgrade command

Try asking

  • “Prepare my OpenRig host for an upgrade to the next version and preserve my running rigs”
  • “Back up the OpenRig SQLite database to a new path before I upgrade”
  • “Check whether my managed plugin files can be refreshed safely without overwriting my local changes”
  • “Inspect the current OpenRig daemon, node, and plugin status before making any changes”
Step-by-step guide: how to use OpenRig Upgrade HelperInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 4 original files, the Apache-2.0 licence and an attribution note.

    openrig-upgrade.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip openrig-upgrade.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip openrig-upgrade.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the inspect script first and resolve any reported gaps before planning a mutation
  • Always take the snapshot and SQLite backup to a new path before any upgrade step, since the helper will never overwrite an existing backup
  • Review the plugin refresh plan output before using --apply-safe, and re-run the plan after any manual fixes

What's inside

  • scripts/backup-sqlite.mjs
  • scripts/inspect-upgrade.mjs
  • scripts/refresh-managed-plugin.mjs
  • SKILL.md

Redistributed unmodified from mvschwarz/openrig under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.