Release v4.9.5

Release v4.9.5 (2026-01-16)

Changes

• chore: Bump version to 4.9.5
• docs(test-status): Update with latest full test suite run
• fix(setup): Use ${CLAUDE_PLUGIN_ROOT} for script paths
• docs(readme): Explain how skills work with Claude Octopus
• docs(readme): Add Recommended Companion Skills section
• docs(test-status): Update with new plugin lifecycle test
• docs(readme): Simplify installation to 2 commands using /plugin
• chore: Remove personal name from package.json
• docs(changelog): Add v4.9.4 release notes
• chore: Exclude coverage reports from git and simplify installer
• test: Fix coverage report path and add infrastructure validation
• docs(readme): Update installation to use official plugin manager

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.9.4

Release v4.9.4 (2026-01-16)

Changes

• chore: Bump version to 4.9.4
• fix(install): Remove broken marketplace config that blocks Claude Code startup

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.9.3

Release v4.9.3 (2026-01-16)

Changes

• chore: Bump version to 4.9.3
• fix(install): Use proper marketplace format and explicit skill paths

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.9.2

Release v4.9.2 (2026-01-16)

Changes

• chore: Bump version to 4.9.2
• fix(install): Clean up old cached installations before installing
• chore: Bump version to 4.9.1
• fix(install): Register plugin properly with Claude Code
• fix(tests): Fix provider detection test flag order
• fix(tests): Fix dry-run test flag order and remove grapple/squeeze tests
• fix(tests): Update smoke tests to match actual implementation
• fix(tests): update smoke tests to match current plugin structure
• docs: clarify installation process and add troubleshooting
• feat: add one-line installer for reliable plugin installation
• refactor: remove /claude-octopus:welcome command, keep only /claude-octopus:setup
• feat: fix plugin structure and add comprehensive test infrastructure
• docs(changelog): Document Claude Code version check feature
• feat(setup): Add Claude Code version check with upgrade guidance
• fix(docs): Use /claude-octopus:setup instead of /welcome in onboarding
• docs(readme): Make /claude-octopus:welcome explicit step 2 in Quick Start
• fix(skill): Make plugin activation automatic without asking permission
• feat(onboarding): Auto-show welcome message for first-time users
• feat(onboarding): Add welcome command for first-time users
• chore: Organize repository - move internal docs to docs/ folder
• chore: Update marketplace.json version to 4.9.0

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.9.1

Release v4.9.1 (2026-01-16)

Changes

• chore: Bump version to 4.9.1
• fix(install): Register plugin properly with Claude Code
• fix(tests): Fix provider detection test flag order
• fix(tests): Fix dry-run test flag order and remove grapple/squeeze tests
• fix(tests): Update smoke tests to match actual implementation
• fix(tests): update smoke tests to match current plugin structure
• docs: clarify installation process and add troubleshooting
• feat: add one-line installer for reliable plugin installation
• refactor: remove /claude-octopus:welcome command, keep only /claude-octopus:setup
• feat: fix plugin structure and add comprehensive test infrastructure
• docs(changelog): Document Claude Code version check feature
• feat(setup): Add Claude Code version check with upgrade guidance
• fix(docs): Use /claude-octopus:setup instead of /welcome in onboarding
• docs(readme): Make /claude-octopus:welcome explicit step 2 in Quick Start
• fix(skill): Make plugin activation automatic without asking permission
• feat(onboarding): Auto-show welcome message for first-time users
• feat(onboarding): Add welcome command for first-time users
• chore: Organize repository - move internal docs to docs/ folder
• chore: Update marketplace.json version to 4.9.0

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

v4.9.0 - Seamless Claude Code Setup Experience

🎉 Major UX Overhaul

This release redesigns the entire setup experience to keep users in Claude Code without terminal context switching.

🚀 Key Features

Fast Provider Detection

• New detect-providers command completes in <1 second
• Clear status codes and smart guidance
• Cache support for performance

Simplified Requirements

• One provider needed (not both Codex AND Gemini!)
• Choose Codex OR Gemini based on your preference
• Graceful degradation with single provider

Conversational Documentation

• Replaced CLI commands with natural language examples
• Talk to Claude naturally: "Research OAuth patterns"
• Rich examples organized by category

New User Role

• Added "Researcher UX/UI Design" role
• Combined research + design workflow
• Renumbered existing roles for better organization

💥 Breaking Changes

• Interactive wizard deprecated (shows warning, will be removed in v5.0)
• Documentation now emphasizes conversational usage

📖 Full Changelog

See CHANGELOG.md for complete details.

🔧 Installation

/plugin marketplace add nyldn/claude-octopus

Then install ONE provider:

npm install -g @openai/codex
# OR
npm install -g @google/gemini-cli

That's it! Just start talking to Claude naturally.

v4.8.3 - Auto-configuration check for first-use UX

Added - Auto-Configuration Check for First-Use Experience

Enhanced Main Skill (skill.md)

• Prerequisites Check Section - Automatic configuration detection before command execution
• First-use notice in skill description - "Automatically detects if configuration is needed and guides setup"

User Experience Improvement

• Seamless onboarding - Users no longer need to discover setup command manually
• Self-healing - Skill automatically detects incomplete config and guides through setup
• Zero-friction activation - "Just talk to Claude naturally!" now works on first use

Fixed

• Command Registration - Commands now properly appear in Claude Code's / menu
  • Changed from array to directory path: "./commands/"
  • Commands appear as /claude-octopus:setup and /claude-octopus:check-updates
  • Matches official plugin pattern (vercel, plugin-dev, etc.)
• Plugin Validation - Fixed schema validation errors in Claude Code v2.1.9
  • Removed unsupported hooks, agents, and plansDirectory fields
  • Simplified plugin.json to match official plugin format

Installation

/plugin marketplace add nyldn/claude-octopus

Or update existing installation:

/plugin marketplace update nyldn-plugins

Files Changed

• Updated skill.md frontmatter description with first-use auto-configuration notice
• Added comprehensive prerequisites checking instructions to skill.md
• Fixed command registration in plugin.json
• Removed unsupported fields from plugin.json for v2.1.9 compatibility
• Updated README.md version badge to 4.8.3

This is primarily a documentation change to skill.md with critical fixes for command registration and plugin validation. The skill instructions now include prerequisite checking that Claude executes automatically before running any octopus commands.

Full Changelog: https://github.com/nyldn/claude-octopus/blob/main/CHANGELOG.md

Release v4.8.2

Release v4.8.2 (2026-01-16)

Changes

• feat(setup): Add essential developer tools setup (v4.8.2)
• perf: Add high-impact performance optimizations (v4.8.1)
• docs(readme): Restructure for quick onboarding

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.8.0

Release v4.8.0 (2026-01-16)

Changes

• chore: Bump plugin version to 4.8.0
• docs(changelog): Add v4.8.0 release notes
• feat(routing): Add subscription-aware multi-provider routing (v4.8)
• docs(changelog): Add v4.7.2 release notes

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins

Release v4.7.2

Release v4.7.2 (2026-01-16)

Changes

• feat(auth): Add Gemini CLI OAuth authentication support

---

See CHANGELOG.md for more details.

Installation:

/plugin marketplace add https://github.com/nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins