v7.5.3 - Enhanced Auto-Update with Error Recovery
What's New
Intelligent Auto-Update System: One-command updates with comprehensive error debugging and guided troubleshooting.
🚀 Key Features
Auto-Update Command
/claude-octopus:update # Check for updates only
/claude-octopus:update --update # Auto-install if outdatedWhat it does:
- ✅ Checks GitHub API for latest release version
- ✅ Compares with your current version
- ✅ Auto-installs with user confirmation
- ✅ Verifies installation success
- ✅ Provides detailed progress reporting
🛠️ Error Recovery & Debugging
Comprehensive error handling for:
Network Errors
- Connection timeout detection
- Firewall/proxy troubleshooting
- GitHub API accessibility checks
GitHub API Issues
- Rate limit detection with recovery instructions
- HTTP status code diagnostics
- Response parsing validation
Installation Failures
- Invalid manifest file debugging
- Schema validation errors (e.g., unsupported
dependenciesfield) - Permission error diagnostics
- Marketplace cache issues
Manual Fallback
If auto-update fails, detailed instructions for:
git clone https://github.com/nyldn/claude-octopus.git ~/claude-octopus
/plugin install ~/claude-octopus📊 Update Process
3-Step Installation:
- 🗑️ Uninstall current version
- 🔄 Update marketplace cache
- 📦 Install latest version
Progress Indicators:
📦 Current version: v7.5.2
🔍 Checking GitHub for latest release...
✅ Latest version on GitHub: v7.5.3
🆕 Update available!
Current: v7.5.2
Latest: v7.5.3
🚀 Starting auto-update to v7.5.3...
🗑️ Step 1/3: Uninstalling current version...
✅ Uninstalled v7.5.2
🔄 Step 2/3: Updating marketplace cache...
✅ Marketplace cache updated
📦 Step 3/3: Installing v7.5.3...
✅ Installed v7.5.3
🔍 Verifying installation...
✅ Verified: v7.5.3 installed
═══════════════════════════════════════════════════════════
✨ Update Complete!
═══════════════════════════════════════════════════════════
🩺 Troubleshooting Guides
Built-in diagnostics for:
- Network connectivity issues
- GitHub API rate limiting
- Marketplace sync problems
- Installation validation errors
Example error recovery:
❌ Error: GitHub API rate limit exceeded
Troubleshooting:
1. Wait ~60 minutes for rate limit reset
2. Check: curl -s https://api.github.com/rate_limit
3. Or visit: https://github.com/nyldn/claude-octopus/releases
📚 Version Compatibility
| Claude Code | Claude-Octopus | Status |
|---|---|---|
| 2.1.12+ | 7.5.3+ | ✅ Recommended |
| 2.1.10+ | 7.4.0+ | ✅ Supported |
| 2.1.7+ | 7.0.0+ | ⚠️ Partial support |
| < 2.1.7 | Any | ❌ Not supported |
🎯 Installation
New Users:
/plugin install claude-octopus@nyldn-pluginsExisting Users (Upgrade):
/claude-octopus:update --update✅ Test Results
All 51 unit tests passing:
- ✅ Documentation sync validation
- ✅ Version consistency across files
- ✅ Skill registration (21 primary skills)
- ✅ Workflow skills (flow-probe, flow-grasp, flow-tangle, flow-ink)
- ✅ Hooks configuration
- ✅ Marketplace version sync
📖 What's Included
All features from v7.5.2:
- ✅ Categorized commands (sys-, flow-, skill-)
- ✅ 15 power user shortcuts
- ✅ Multi-agent orchestration (Codex/Gemini)
- ✅ AI Debate Hub integration
- ✅ Visual workflow indicators
- ✅ Natural language triggers
Plus new in v7.5.3:
- ✨ Enhanced auto-update system
- ✨ Comprehensive error recovery
- ✨ Guided troubleshooting
- ✨ Installation verification
🔗 Links
- Documentation: https://github.com/nyldn/claude-octopus#readme
- Changelog: https://github.com/nyldn/claude-octopus/blob/main/CHANGELOG.md
- Issues: https://github.com/nyldn/claude-octopus/issues
- Migration Guide: https://github.com/nyldn/claude-octopus/blob/main/docs/MIGRATION-v7.5.md
Full Changelog: v7.5.2...v7.5.3