# Updater Guide

> Guidance for checking for and installing Row-Bot updates.

- Skill: `siddsachar/updater-guide` (Agent Skill)
- Install (CLI): `npx skillmds@latest add siddsachar/updater-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/siddsachar/updater-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: siddsachar (https://skillmd.com/u/siddsachar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/siddsachar/updater-guide

---

ROW-BOT AUTO-UPDATE:
- Row-Bot checks GitHub Releases automatically in the background. There is
  no opt-in toggle: when Internet is available, the assistant polls
  the configured Row-Bot release repository for new releases and silently
  ignores network failures.
- Updates are NEVER installed automatically. The user must always
  approve installation.

WHEN TO MENTION UPDATES:
- The injected dynamic state will include an "Update available: v…" line
  when one exists. If the user asks "what's new" / "is there an update",
  surface the version + a one-line summary.
- Do NOT nag — mention proactively at most once per conversation.
- If an update is in `skipped_versions`, do not re-offer it unless the
  user explicitly asks.

CHECKING (row_bot_check_for_updates):
- Read-only. Polls GitHub once and returns the available version (if any),
  channel, summary, and release page URL.
- Honors the user's channel: 'stable' (default) or 'beta'.
- Failures (offline, rate-limited) are reported but not treated as errors.

INSTALLING (row_bot_install_update):
- Always asks the user for confirmation via an interrupt.
- On approval: downloads the asset to ~/.row-bot/updates/, verifies SHA256,
  verifies the OS code signature (signtool/codesign), then hands off to
  the OS installer and exits Row-Bot.
- Windows: launches `Row-Bot-x.y.z-Windows-x64.exe /SILENT /CLOSEAPPLICATIONS
  /RESTARTAPPLICATIONS`. The new version starts automatically after install.
- macOS: opens the DMG in Finder; the user drags Row-Bot.app into
  /Applications.
- Refuses to install when running from a development checkout
  (presence of `.git/` next to the app).

CHANNEL & SKIPPING:
- The channel is set in Settings → Preferences → Updates and persisted in
  ~/.row-bot/update_config.json. Do not change it without asking.
- Users can skip a specific version from the "What's New" dialog. Skipped
  versions are surfaced via row_bot_status category='updates'.

ERROR HANDLING:
- SHA256 mismatch or signature failure: do NOT retry blindly — surface the
  message verbatim and suggest the user open the GitHub release page.
- Network failure: a one-line "couldn't reach GitHub" suffices.