The --flow-display flag enables visual workflow tracking, showing the progress of agent executions in real-time.
Quick Start
praisonai agents.yaml --flow-display
Usage
Basic Flow Display
praisonai "Multi-step task" --planning --flow-display
🎬 Flow Display enabled
╭─ Workflow: Multi-step task ──────────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Start │───▶│ Planning │───▶│ Execute │ │
│ │ │ │ ⏳ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
📋 PLANNING PHASE
Creating implementation plan...
╭─ Workflow: Multi-step task ──────────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Start │───▶│ Planning │───▶│ Execute │ │
│ │ ✅ │ │ ✅ │ │ ⏳ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
🚀 EXECUTION PHASE
Executing plan steps...
[Response output...]
╭─ Workflow: Multi-step task ──────────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Start │───▶│ Planning │───▶│ Execute │ │
│ │ ✅ │ │ ✅ │ │ ✅ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ Duration: 12.5s | Status: ✅ Complete │
╰──────────────────────────────────────────────────────────────────────────────╯
With YAML Agents
praisonai agents.yaml --flow-display
🎬 Flow Display enabled
╭─ Workflow: Research and Write ───────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Researcher │───▶│ Writer │───▶│ Editor │───▶│ Output │ │
│ │ ⏳ │ │ │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
━━━ Agent: Researcher ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Research output...]
╭─ Workflow: Research and Write ───────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Researcher │───▶│ Writer │───▶│ Editor │───▶│ Output │ │
│ │ ✅ │ │ ⏳ │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
━━━ Agent: Writer ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Writing output...]
[Continues through all agents...]
╭─ Workflow: Research and Write ───────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Researcher │───▶│ Writer │───▶│ Editor │───▶│ Output │ │
│ │ ✅ │ │ ✅ │ │ ✅ │ │ ✅ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ Duration: 45.2s | Agents: 3 | Status: ✅ Complete │
╰──────────────────────────────────────────────────────────────────────────────╯
With Handoff
praisonai "Research and write" --handoff "researcher,writer,editor" --flow-display
🎬 Flow Display enabled
🤝 Handoff chain: researcher → writer → editor
╭─ Handoff Flow ───────────────────────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ researcher │────────▶│ writer │────────▶│ editor │ │
│ │ ⏳ │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
[Execution with visual updates...]
Combine with Other Features
# Flow display with metrics
praisonai "Complex task" --planning --flow-display --metrics
# Flow display with handoff and guardrail
praisonai "Write code" --handoff "coder,reviewer" --flow-display --guardrail "Best practices"
Visual Elements
Status Icons
| Icon | Meaning |
|---|
| ⏳ | In progress |
| ✅ | Completed successfully |
| ❌ | Failed |
| ⏸️ | Paused/Waiting |
| 🔄 | Retrying |
Flow Indicators
┌─────────────┐ ┌─────────────┐
│ Agent 1 │───▶│ Agent 2 │
│ ✅ │ │ ⏳ │
└─────────────┘ └─────────────┘
- Boxes represent agents/steps
- Arrows show flow direction
- Status icons show current state
Use Cases
Debugging Workflows
# See where a workflow fails
praisonai agents.yaml --flow-display -v
╭─ Workflow: Data Pipeline ────────────────────────────────────────────────────╮
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Fetch │───▶│ Transform │───▶│ Load │ │
│ │ ✅ │ │ ❌ │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ❌ Error at: Transform │
│ Message: Invalid data format │
╰──────────────────────────────────────────────────────────────────────────────╯
Monitoring Long Tasks
# Track progress of complex research
praisonai "Comprehensive market analysis" --planning --flow-display
Demo/Presentation
# Visual workflow for demonstrations
praisonai agents.yaml --flow-display
Flow Display Modes
Sequential Flow
┌───────┐ ┌───────┐ ┌───────┐
│ Step1 │───▶│ Step2 │───▶│ Step3 │
└───────┘ └───────┘ └───────┘
Parallel Flow
┌───────┐
┌───▶│ Task1 │───┐
┌───────┐│ └───────┘ │┌───────┐
│ Start │┤ ├▶│ End │
└───────┘│ ┌───────┐ │└───────┘
└───▶│ Task2 │───┘
└───────┘
Hierarchical Flow
┌─────────────────────────────────┐
│ Manager │
│ │ │
│ ┌─────────┼─────────┐ │
│ ▼ ▼ ▼ │
│ ┌─────┐ ┌─────┐ ┌─────┐ │
│ │ W1 │ │ W2 │ │ W3 │ │
│ └─────┘ └─────┘ └─────┘ │
└─────────────────────────────────┘
Best Practices
Use --flow-display with --planning to see the full workflow from planning to execution.
Complex Workflows
Best for multi-agent or multi-step workflows
Debugging
Helps identify where workflows fail
Demonstrations
Great for showing workflow progress to stakeholders
Monitoring
Track long-running tasks visually
Terminal Requirements
Flow display works best in terminals that support Unicode and ANSI colors. Most modern terminals (iTerm2, Windows Terminal, VS Code terminal) support these features.
| Terminal | Support |
|---|
| iTerm2 | ✅ Full |
| Windows Terminal | ✅ Full |
| VS Code Terminal | ✅ Full |
| macOS Terminal | ✅ Full |
| Basic terminals | ⚠️ Limited |
