nyldn/claude-octopus v7.4.0

v7.4.0 - Visual Feedback & Natural Language Workflows

on GitHub

Visual Feedback System 🐙🔴🟡🔵

Now you always know what's running! v7.4 adds visual indicators so you can distinguish external CLI execution (uses your API quotas) from Claude subagents (included with Claude Code).

Visual Indicators

• 🐙 Parallel Mode - Multiple CLIs orchestrated via orchestrate.sh
• 🔴 Codex CLI - OpenAI Codex (your OPENAI_API_KEY)
• 🟡 Gemini CLI - Google Gemini (your GEMINI_API_KEY)
• 🔵 Claude Subagent - Claude Code Task tool (built-in, no additional cost)

📖 Complete Visual Indicators Guide →

Natural Language Workflow Triggers

No more CLI commands! Just talk naturally:

• "research X" → Probe workflow (🐙 🔍)
• "define requirements for X" → Grasp workflow (🐙 🎯)
• "build X" → Tangle workflow (🐙 🛠️)
• "review X" → Ink workflow (🐙 ✅)

📖 Complete Triggers Guide →

What's New

Added

• 🆕 Visual feedback system - Hook-based indicators for provider execution
• 🆕 Natural language workflow triggers - Four workflow skills with automatic activation
• 🆕 Comprehensive documentation - 4 new guide files (VISUAL-INDICATORS.md, TRIGGERS.md, CLI-REFERENCE.md, PLUGIN-ARCHITECTURE.md)
• 🆕 Test suites - YAML frontmatter validation and documentation sync checks

Fixed

• ✅ /debate skill visibility - Added proper YAML frontmatter wrapper for Claude Code recognition
• ✅ README clarity - Plugin-first approach, reduced from 1,121 to 485 lines (57% reduction)
• ✅ Documentation structure - CLI reference extracted to separate guide

Enhanced

• 📈 parallel-agents.md - Added visual indicators section and cost awareness
• 📈 Hook system - PreToolUse hooks for orchestrate.sh, Codex CLI, and Gemini CLI
• 📈 Plugin registration - All new workflow skills registered in plugin.json

Files Changed

New Files (11):

• .claude/hooks/visual-feedback.sh - Provider detection hook
• .claude/skills/debate.md - YAML frontmatter wrapper for /debate
• .claude/skills/probe-workflow.md - Natural language research trigger
• .claude/skills/grasp-workflow.md - Natural language definition trigger
• .claude/skills/tangle-workflow.md - Natural language implementation trigger
• .claude/skills/ink-workflow.md - Natural language validation trigger
• docs/VISUAL-INDICATORS.md - Comprehensive visual feedback guide
• docs/TRIGGERS.md - Detailed trigger patterns guide
• docs/CLI-REFERENCE.md - Advanced CLI usage reference
• tests/unit/test-skill-frontmatter.sh - YAML frontmatter validation
• tests/unit/test-docs-sync.sh - Version and documentation sync validation

Modified Files (5):

• .claude-plugin/hooks.json - Added visual indicator hooks
• .claude-plugin/plugin.json - Registered workflow skills
• .claude/skills/parallel-agents.md - Added visual indicators section
• README.md - Plugin-first rewrite and reorganization
• CHANGELOG.md - Documented v7.4.0 changes

Installation

New Users

/plugin marketplace add nyldn/claude-octopus
/plugin install claude-octopus@nyldn-plugins
/claude-octopus:setup

Existing Users (Update)

Option A: Via Plugin UI

1. /plugin to open plugin screen
2. Navigate to "Installed" tab
3. Find claude-octopus@nyldn-plugins
4. Click update button

Option B: Reinstall (Most Reliable)

/plugin uninstall claude-octopus
/plugin marketplace update nyldn-plugins
/plugin install claude-octopus@nyldn-plugins

After updating: Restart Claude Code to load the new version.

What's Next

Check out the new documentation:

• 📖 Visual Indicators Guide - Understand what's running
• 📖 Triggers Guide - Learn what activates workflows
• 📖 CLI Reference - Advanced CLI usage
• 📖 Plugin Architecture - How it all works

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