11# Dispatcher Reference - flow-cli
22
3- ** Last Updated:** January 12 , 2026
4- ** Version:** flow-cli v5.4.1
3+ ** Last Updated:** January 14 , 2026
4+ ** Version:** flow-cli v5.8.0
55
66---
77
@@ -13,7 +13,7 @@ Dispatchers are smart command routers that provide context-aware workflows for s
1313
1414---
1515
16- ## Active Dispatchers (10 )
16+ ## Active Dispatchers (11 )
1717
1818### 1. ` g ` - Git Workflows
1919
@@ -142,7 +142,63 @@ obs analyze # Analyze vault
142142
143143---
144144
145- ### 4. ` qu ` - Quarto Publishing
145+ ### 4. ` prompt ` - Prompt Engine Manager
146+
147+ ** File:** ` prompt-dispatcher.zsh `
148+ ** Purpose:** Unified management of prompt themes (Powerlevel10k, Starship, Oh My Posh)
149+ ** Added:** January 14, 2026 (v5.7.0)
150+
151+ ** Common Commands:**
152+
153+ ``` bash
154+ # Status & info
155+ prompt # Show help (default)
156+ prompt status # Show current engine + alternatives
157+ prompt list # Table view of all engines
158+
159+ # Engine switching
160+ prompt toggle # Interactive menu to pick engine
161+ prompt starship # Switch to Starship
162+ prompt p10k # Switch to Powerlevel10k
163+ prompt ohmyposh # Switch to Oh My Posh
164+
165+ # Setup & configuration
166+ prompt setup-ohmyposh # Interactive Oh My Posh wizard
167+ prompt help # Show help
168+
169+ # Options
170+ prompt --dry-run toggle # Preview changes without applying
171+ ```
172+
173+ ** Supported Engines:**
174+
175+ | Engine | Config Path | Description |
176+ | --------| -------------| -------------|
177+ | Powerlevel10k | ` ~/.config/zsh/.p10k.zsh ` | Feature-rich, highly customizable |
178+ | Starship | ` ~/.config/starship.toml ` | Minimal, fast Rust-based |
179+ | Oh My Posh | ` ~/.config/ohmyposh/config.json ` | Modular with extensive themes |
180+
181+ ** Environment Variable:**
182+
183+ ``` bash
184+ # Control which engine is active
185+ export FLOW_PROMPT_ENGINE=" starship" # Valid: powerlevel10k, starship, ohmyposh
186+ ```
187+
188+ ** Features:**
189+
190+ - One-command engine switching with validation
191+ - Interactive toggle menu for quick switching
192+ - Dry-run mode to preview changes
193+ - Automatic shell reload after switch
194+ - Setup wizard for Oh My Posh
195+ - Integration with ` flow doctor ` for health checks
196+
197+ ** See also:** [ PROMPT-DISPATCHER-REFERENCE.md] ( PROMPT-DISPATCHER-REFERENCE.md )
198+
199+ ---
200+
201+ ### 5. ` qu ` - Quarto Publishing
146202
147203** File:** ` qu-dispatcher.zsh `
148204** Purpose:** Quarto document and presentation workflows
@@ -193,7 +249,7 @@ qu commit # Render and commit changes
193249
194250---
195251
196- ### 5 . ` r ` - R Package Development
252+ ### 6 . ` r ` - R Package Development
197253
198254** File:** ` r-dispatcher.zsh `
199255** Purpose:** R package development workflows
@@ -259,7 +315,7 @@ r tree # Package structure tree
259315
260316---
261317
262- ### 6 . ` cc ` - Claude Code Workflows
318+ ### 7 . ` cc ` - Claude Code Workflows
263319
264320** File:** ` cc-dispatcher.zsh `
265321** Purpose:** Smart Claude Code project workflows
@@ -323,7 +379,7 @@ cc wt opus <branch> # Worktree + Opus model
323379
324380---
325381
326- ### 7 . ` wt ` - Git Worktree Management
382+ ### 8 . ` wt ` - Git Worktree Management
327383
328384** File:** ` wt-dispatcher.zsh `
329385** Purpose:** Git worktree management for parallel development
@@ -383,7 +439,7 @@ wt unlock <path> # → git worktree unlock <path>
383439
384440---
385441
386- ### 8 . ` tm ` - Terminal Manager
442+ ### 9 . ` tm ` - Terminal Manager
387443
388444** File:** ` tm-dispatcher.zsh `
389445** Purpose:** Terminal management via aiterm integration
@@ -445,7 +501,7 @@ Automatically detects: iTerm2, Ghostty, WezTerm, Kitty, Alacritty, VS Code, Term
445501
446502---
447503
448- ### 9 . ` dot ` - Dotfile Management
504+ ### 10 . ` dot ` - Dotfile Management
449505
450506** File:** ` dot-dispatcher.zsh `
451507** Purpose:** Dotfile sync via chezmoi + secret management via Bitwarden
@@ -548,7 +604,7 @@ Use Bitwarden secrets in chezmoi templates:
548604
549605---
550606
551- ### 10 . ` teach ` - Teaching Workflow
607+ ### 11 . ` teach ` - Teaching Workflow
552608
553609** File:** ` teach-dispatcher.zsh `
554610** Purpose:** Unified teaching workflow for course websites
@@ -846,10 +902,27 @@ source ~/projects/dev-tools/flow-cli/lib/dispatchers/<name>.zsh
846902
847903## Summary
848904
849- ** Active Dispatchers:** 8 (g, mcp, obs, qu, r, cc, wt, tm)
905+ ** Active Dispatchers:** 11 (g, mcp, obs, prompt, qu, r, cc, wt, tm, dot, teach )
850906** Removed:** 2 (v, vibe)
851907** Not Restored:** 3 (gm, note, timer - alternatives available)
852- ** Total Commands:** ~ 130+ subcommands across all dispatchers
908+ ** Total Commands:** ~ 150+ subcommands across all dispatchers
909+
910+ ** New in v5.7.0:**
911+
912+ - ` prompt ` dispatcher - Prompt engine manager (Powerlevel10k, Starship, Oh My Posh)
913+ - Interactive engine switching with validation
914+ - Dry-run mode for previewing changes
915+ - Setup wizard for Oh My Posh
916+
917+ ** New in v5.4.1:**
918+
919+ - ` teach ` dispatcher - Teaching workflow for course websites
920+ - Non-interactive mode with ` -y ` flag
921+
922+ ** New in v5.0.0:**
923+
924+ - ` dot ` dispatcher - Dotfile management + secret management
925+ - macOS Keychain integration (v5.5.0)
853926
854927** New in v4.4.0:**
855928
0 commit comments