V3 CLI Modernization
CLI modernization and hooks system enhancement for claude-flow v3. Implements interactive prompts, command decomposition, enhanced hooks integration, and intelligent workflow automation.
Profile →npx skills add ruvnet/ruflo --skill v3-cli-modernization --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What This Skill Does
Modernizes claude-flow v3 CLI with interactive prompts, intelligent command decomposition, enhanced hooks integration, performance optimization, and comprehensive workflow automation capabilities.
How it works
The skill reorganizes the CLI into modular commands and categories, with a registry that supports exact, alias, and fuzzy command resolution. It implements a swarm-learning style set of modules (e.g., SwarmCommand and LearningCommand) that expose subcommands and options, including interactive modes that leverage an InteractivePromptService. The prompt service dynamically imports inquirer for select, multiselect, input, progress, and confirmation interactions, and it can render a progress bar via cli-progress during long-running tasks.
Interactive prompts are used for things like topology selection, agent configuration, and contextual inputs. The system supports a deep hooks layer: a CLIHooksManager registers handlers for command_start, command_end, command_error, agent_spawn, and task_complete events, and integrates a LearningHooksIntegration component to record trajectories, compute rewards, and feed back into learning systems. The integration stores experiences, records performance metrics, and can store patterns for future optimization.
The architecture includes a modular command registry with types like CommandModule, and the execution path resolves a command by name, alias, or fuzzy match, builds an execution context, and runs the middleware stack. The SwarmCommand demonstrates interactive and non-interactive initialization, and the LearningCommand handles automated algorithm selection, session management, and metrics.
When to use it
Use when modernizing a CLI to support modular commands, interactive flows, enhanced hook lifecycle integration, and a learning-driven improvement loop. Trigger tasks when initializing or managing complex workflows, coordinating multiple agents, or needing intelligent command orchestration and feedback-driven optimization.
What it can touch
- Commands: ModularCommandRegistry, SwarmCommand, LearningCommand
- Interactive prompts: InteractivePromptService (select, multiSelect, input, progress, confirmWithDetails)
- Hooks: CLIHooksManager, LearningHooksIntegration
- Learning and tracking: LearningHooksIntegration, AgentDBLearningClient, AgenticFlowHooksClient (references shown in code)
- External utilities: inquirer, cli-progress
Caveats
MIT license is stated. The skill relies on dynamic imports for inquirer and cli-progress, which may affect startup performance if not tree-shaken. It requires hosting of supporting services (AgenticFlowHooksClient, AgentDBLearningClient) for full learning integration. No additional risk notes beyond what's present in the implementation are stated.
# V3 CLI Modernization ## What This Skill Does Modernizes claude-flow v3 CLI with interactive prompts, intelligent command decomposition, enhanced hooks integration, performance optimization, and comprehensive workflow automation capabilities. ## Quick Start ```bash # Initialize CLI modernization analysis Task("CLI architecture", "Analyze current CLI structure and identify optimization opportunities", "cli-hooks-developer") # Modernization implementation (parallel) Task("Command decomposition", "Break down large CLI files into focused modules", "cli-hooks-developer") Task("Interactive prompts", "Implement intelligent interactive CLI experience", "cli-hooks-developer") Task("Hooks enhancement", "Deep integrate hooks with CLI lifecycle", "cli-hooks-developer") ``` ## CLI Architecture Modernization ### Current State Analysis ``` Current CLI Issues: ├── index.ts: 108KB monolithic file ├── enterprise.ts: 68KB feature module ├── Limited interactivity: Basic command parsing ├── Hooks integration: Basic pre$post execution └── No intelligent workflows: Manual command chaining Target Architecture: ├── Modular Commands: <500 lines per command ├── Interactive Prompts: Smart context-aware UX ├─
- What This Skill Does
- Quick Start
- CLI Architecture Modernization
- Current State Analysis
- Modular Command Architecture
- Command Decomposition Strategy
- Swarm Commands Module
- Learning Commands Module
- Interactive Prompt System
- Advanced Prompt Service
- Enhanced Hooks Integration
- Deep CLI Hooks Integration
- Learning Integration
- Intelligent Workflow Automation
Initialize CLI modernization analysis Modernization implementation (parallel) Full CLI modernization implementation Enhanced interactive commands claude-flow swarm init --interactive claude-flow learning start --guided claude-flow workflow create --from-intent "setup new project"
What does the V3 CLI Modernization skill do?
CLI modernization and hooks system enhancement for claude-flow v3. Implements interactive prompts, command decomposition, enhanced hooks integration, and intelligent workflow automation.
How do I install it?
Run `npx skills add ruvnet/ruflo --skill v3-cli-modernization --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ruvnet/ruflo, a repository with 67,015 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.