Skip to content

cli-reference.md

Latest commit

 

History

History
116 lines (92 loc) · 4.24 KB

cli-reference.md

File metadata and controls

116 lines (92 loc) · 4.24 KB

CLI Reference

Installation

npx devflow-kit init

The interactive wizard offers two modes:

  • Recommended (default) — Sensible defaults, quick setup
  • Advanced — Full interactive flow with all options

Use --recommended or --advanced flags for non-interactive setup.

Init Options

Option Description
--plugin <names> Comma-separated plugin names (e.g., implement,code-review)
--scope <user|local> Installation scope (default: user)
--teams / --no-teams Enable/disable Agent Teams (default: off)
--ambient / --no-ambient Enable/disable ambient mode (default: on)
--memory / --no-memory Enable/disable working memory (default: on)
--learn / --no-learn Enable/disable self-learning (default: on)
--hud / --no-hud Enable/disable HUD status line (default: on)
--hud-only Install only the HUD (no plugins, hooks, or extras)
--verbose Show detailed output

Scopes

  • --scope user (default) — Install for all projects (~/.claude/)
  • --scope local — Install for current project only (.claude/)

Plugin Management

npx devflow-kit list                          # List available plugins
npx devflow-kit init --plugin=implement       # Install specific plugin
npx devflow-kit init --plugin=implement,code-review  # Install multiple

Available Plugins

Plugin Type Description
devflow-specify Core Feature specification workflow
devflow-implement Core Complete task implementation lifecycle
devflow-code-review Core Comprehensive code review
devflow-resolve Core Review issue resolution
devflow-debug Core Competing hypothesis debugging
devflow-self-review Core Simplifier + Scrutinizer
devflow-ambient Core Ambient mode (always-on intent classification)
devflow-core-skills Core Auto-activating quality skills
devflow-typescript Language TypeScript patterns
devflow-react Language React patterns
devflow-accessibility Language Web accessibility patterns
devflow-ui-design Language UI design patterns
devflow-go Language Go patterns
devflow-python Language Python patterns
devflow-java Language Java patterns
devflow-rust Language Rust patterns

Ambient Mode

npx devflow-kit ambient --enable     # Enable always-on ambient mode
npx devflow-kit ambient --disable    # Disable ambient mode
npx devflow-kit ambient --status     # Show current status

Self-Learning

npx devflow-kit learn --enable       # Register the learning hook
npx devflow-kit learn --disable      # Remove the learning hook
npx devflow-kit learn --status       # Show status and observation counts
npx devflow-kit learn --list         # Show all observations by confidence
npx devflow-kit learn --configure    # Interactive config (model, throttle, caps)
npx devflow-kit learn --clear        # Reset all observations
npx devflow-kit learn --purge        # Remove invalid/corrupted entries

HUD (Status Line)

npx devflow-kit hud --status         # Show current HUD config
npx devflow-kit hud --enable         # Enable HUD
npx devflow-kit hud --disable        # Disable HUD
npx devflow-kit hud --detail         # Show tool/agent descriptions
npx devflow-kit hud --no-detail      # Hide tool/agent descriptions

Skill Shadowing

Override any DevFlow skill with your own version. Shadowed skills survive devflow init — your version is installed instead of DevFlow's.

npx devflow-kit skills shadow software-design    # Create override (copies current as reference)
vim ~/.devflow/skills/software-design/SKILL.md   # Edit your override
npx devflow-kit skills list-shadowed             # List all overrides
npx devflow-kit skills unshadow software-design  # Remove override

Uninstall

npx devflow-kit uninstall
Option Description
--scope <user|local> Uninstall scope (default: user)
--plugin <names> Selective uninstall by plugin name
--keep-docs Preserve .docs/ directory
--dry-run Show what would be removed
--verbose Show detailed output