Agents CLI
The PraisonAI TypeScript CLI provides commands for running multi-agent orchestration directly from the command line.Commands Overview
agents run
Run multiple agents in sequence or parallel.Basic Usage
With Inline Agents
Options
| Option | Description | Default |
|---|---|---|
--config, -c | Path to agents YAML config | - |
--agents, -a | Inline agent definitions (name:instructions) | - |
--task, -t | Task to execute | - |
--process, -p | Process mode: sequential, parallel | sequential |
--model, -m | LLM model for all agents | gpt-4o-mini |
--verbose, -v | Enable verbose output | true |
--json | Output as JSON | false |
Examples
Configuration File Format
agents.yaml
With Tasks
With Tools
JSON Output Format
Process Modes
Sequential
Agents run one after another. Each agent receives the previous agent’s output:Parallel
All agents run simultaneously:Environment Variables
Scripting Examples
Bash Pipeline
Error Handling
Common Patterns
Research → Write Pipeline
Multi-Perspective Analysis
Parallel Data Collection
See Also
- Agents - Multi-agent class documentation
- Agent CLI - Single agent CLI
- Workflow CLI - Workflow CLI commands

