skills.rest
AMC-JTC
AMC-JTCCOMMUNITY
Explore all skills by this author →
GitHub

gbrain-upgrade

Applies gbrain self-upgrades from UPGRADE_AVAILABLE markers according to the configured notify or auto mode.

Updated Aug 17, 2026
Search Tags:#automation#changelog#cli#update management#self-upgrade#version check#gbrain
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill gbrain-upgrade-amc-jtc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gbrain-upgrade
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/plugin/skills/gbrain-upgrade
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill gbrain-upgrade-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When gbrain prints an UPGRADE_AVAILABLE marker on stderr, someone must decide whether and how to apply the update without interrupting ongoing work or trusting potentially forged marker text. This Skill turns that marker into the correct action for the operator's configured self_upgrade.mode. ## Core Features & Use Cases - Mode-aware upgrade handling: Reads self_upgrade.mode (auto, notify, off) and applies the matching behavior — silent upgrade, interactive prompt, or no action. - Safe command execution: Only ever runs the hardcoded gbrain self-upgrade command, never a command parsed from marker text, protecting against forged markers. - Informed prompting: In notify mode, summarizes changelog_diff into plain bullets and presents a 4-option choice (upgrade now, always auto, snooze, disable). - Use Case: During a coding session, a gbrain call prints UPGRADE_AVAILABLE 0.45.0 0.46.0. The Skill checks the mode, shows what's new, asks the operator, and either upgrades or snoozes without blocking the current task. ## Quick Start When you see an UPGRADE_AVAILABLE marker from any gbrain command, ask the assistant to handle the gbrain update according to the configured self-upgrade mode.

Frequently Asked Questions about gbrain-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update gbrain to the latest version?▼

Run gbrain self-upgrade to apply the latest version directly. To check first, run gbrain self-upgrade --check-only --json, which reports update_available, changelog_diff, and the release URL before you commit.

How do I configure gbrain automatic updates?▼

Set the mode with gbrain config set self_upgrade.mode auto for silent upgrades, notify for an interactive prompt, or off to disable checks. The default is notify, which is recommended for interactive workstations.

Is it safe to run commands from the UPGRADE_AVAILABLE marker?▼

No. The marker text is never executed; the only commands run are the hardcoded gbrain self-upgrade, gbrain upgrade, and gbrain config set. This prevents a forged marker from a brain page or MCP response from running arbitrary code.

What happens if I decline a gbrain update?▼

Choosing Not now snoozes the update with escalating intervals of 24 hours, then 48 hours, then 7 days. The marker stops nagging for that version until the snooze expires or a newer version ships.

Why does gbrain skip a version that failed to upgrade?▼

Versions recorded in self_upgrade.failed_versions are skipped automatically, and gbrain doctor surfaces them in its self_upgrade_health check. The Skill will not retry those versions and instead surfaces the paste-ready hint from the doctor output.

Related Skills

Explore More Software Engineering Skills→
tblakex01tblakex01
1

setup-gbrain

Install the gbrain CLI, initialize a local brain, and register MCP.

Community
Advanced
yunusgungoryunusgungor

skillpack-check

Generate a JSON health report combining gbrain doctor and migration status.

Community
Intermediate
mscully4mscully4

skillpack-check

Generate a health report for the gbrain skillpack using gbrain doctor and apply-migrations commands.

Community
Basic
SigmacodeatSigmacodeat

gbrain-upgrade

Detect available gbrain upgrades and apply configured self-upgrade modes.

Community
Advanced