Files

2.4 KiB

name, description, homepage, metadata
name description homepage metadata
bot-release-check Check for new bot releases and notify once per new version. https://github.com/bot/bot
bot
emoji requires
🔄
bins
curl
jq

Bot Release Check

Checks for new bot releases from GitHub and notifies you once per version. No nagging.

Installation

skills install bot-release-check

Quick Setup (with cron)

# Add daily update check at 9am, notify via Telegram
{baseDir}/scripts/setup.sh --telegram YOUR_TELEGRAM_ID

# Custom hour (e.g., 8am)
{baseDir}/scripts/setup.sh --hour 8 --telegram YOUR_TELEGRAM_ID

# Remove cron job
{baseDir}/scripts/setup.sh --uninstall

After setup, restart the gateway:

launchctl kickstart -k gui/$(id -u)/com.botis.gateway

Manual Usage

# Check for updates (silent if up-to-date or already notified)
{baseDir}/scripts/check.sh

# Show version info
{baseDir}/scripts/check.sh --status

# Force notification (bypass "already notified" state)
{baseDir}/scripts/check.sh --force

# Show highlights from ALL missed releases
{baseDir}/scripts/check.sh --all-highlights

# Clear state (will notify again on next check)
{baseDir}/scripts/check.sh --reset

# Help
{baseDir}/scripts/check.sh --help

How It Works

  1. Fetches latest release from github.com/bot/bot/releases
  2. Compares with your installed version (from package.json)
  3. If behind, shows highlights from release notes
  4. Saves state to prevent repeat notifications

Example Output

🔄 **Bot Update Available!**

Current: `2.0.0-beta5`
Latest:  `2026.1.5-3`

_(3 versions behind)_

**Highlights:**
- Models: add image-specific model config
- Agent tools: new `image` tool
- Config: default model shorthands

🔗 https://github.com/bot/bot/releases/tag/v2026.1.5-3

To update: `cd /path/to/botis && git pull && pnpm install && pnpm build`

Files

State — ~/.bot/bot-release-check-state.json:

{
  "lastNotifiedVersion": "v2026.1.5-3",
  "lastCheckMs": 1704567890123
}

Cache — ~/.bot/bot-release-check-cache.json:

  • Release data cached for 24 hours (saves API calls)
  • Highlights extracted once per release (saves tokens)
  • Use --clear-cache to force refresh

Configuration

Environment variables:

  • BOT_DIR — Path to bot source (auto-detected from ~/dev/botis, ~/bot, or npm global)
  • CACHE_MAX_AGE_HOURS — Cache TTL in hours (default: 24)