Skip to content

GBrain Self-Upgrade

Keeps the gbrain tool updated, asking or acting based on the user's chosen update mode.

Repository
garrytan/gbrain
Stars
31,447
Licence
MIT
Files
1 file

What it does

gbrain is a command-line tool that checks for its own updates whenever it runs and prints a marker when a newer version exists. With this skill installed, the agent notices that marker and handles it according to the user's setting: it either asks the operator whether to upgrade (with a short summary of changes and options to say yes, always, not now, or never) or upgrades silently if the operator has opted in. The skill also covers a careful multi-step process for servers that keep gbrain running, and it pauses for human approval when a release requires a manual migration.

Great for

  • Developers who run gbrain on their own machine or server and want updates handled for them
  • Operators of always-on gbrain hosts who need a safe, ordered upgrade and restart procedure
  • Teams that want control over whether upgrades happen automatically or only after approval

Skip it if

  • Users who do not use gbrain, since the skill only acts on gbrain commands and markers (it has no use otherwise)
  • Unattended auto-mode setups across releases that require an attended cutover, because the daemon does not read migration playbooks and could upgrade without the required manual steps unless the operator switches modes first
  • Anyone expecting the skill to verify release contents itself; it relies on the gbrain self-upgrade command and its changelog data

Try asking

  • “gbrain update available”
  • “Upgrade gbrain to the latest version”
  • “Is gbrain up to date?”
  • “Keep gbrain current on this always-on host”
Step-by-step guide: how to use GBrain Self-UpgradeInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    gbrain-upgrade.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gbrain-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

  • Keep the default notify mode if you want to approve every upgrade; choose auto only for installs without release-specific manual steps.
  • For production or large brains, follow the stable channel and read any migration playbook the skill points to before approving an upgrade.
  • Ask the agent to report the version each running process uses after an upgrade, not just the printed version.

What's inside

  • SKILL.md

Redistributed unmodified from garrytan/gbrain under the MIT 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.