CLI Reference - PraisonAI

The praisonai-ts CLI provides a comprehensive interface for interacting with AI agents.

Quick Start

Simple Usage

npm install -g praisonai
praisonai-ts chat "Hello"

With Configuration

export OPENAI_API_KEY=your-key
praisonai-ts chat "Explain AI" --model openai/gpt-4o-mini

All Commands

Command	Description
`chat`	Chat with an AI agent
`run`	Run an agent with a task
`workflow`	Execute a multi-agent workflow
`auto`	Auto-generate agents from topic
`research`	Deep research on a topic
`image`	Image generation and analysis
`providers`	List available LLM providers
`tools`	List or manage tools
`memory`	Manage agent memory
`session`	Manage agent sessions
`knowledge`	Manage knowledge base
`skills`	Manage agent skills
`guardrail`	Content validation and safety
`eval`	Evaluate agent performance
`query-rewrite`	Rewrite queries for better search
`prompt-expand`	Expand prompts with more detail
`router`	Route requests to agents
`context`	Manage conversation context
`planning`	Task planning and todo management
`telemetry`	Usage monitoring and analytics
`vector`	Vector store management
`observability`	Monitoring and tracing
`voice`	Text-to-speech and speech-to-text
`db`	Database adapter management
`cache`	Caching management
`version`	Show CLI version
`help`	Show help information

Core Commands

Chat

praisonai-ts chat "Your prompt here"
praisonai-ts chat "Write a poem" --stream
praisonai-ts chat "Explain AI" --model anthropic/claude-sonnet-4-20250514

Providers

praisonai-ts providers
praisonai-ts providers --json

Global Options

Option	Description
`-v, --verbose`	Enable verbose output
`-c, --config`	Path to config file
`-o, --output`	Output format (pretty, json, text)
`--json`	Shorthand for `--output json`

Environment Variables

export OPENAI_API_KEY=your-key
export ANTHROPIC_API_KEY=your-key
export GOOGLE_API_KEY=your-key
export PRAISONAI_MODEL=openai/gpt-4o-mini

Tools CLI

Command reference

Providers CLI

Command reference

Sessions CLI

Command reference

Memory CLI

Command reference

Knowledge Base CLI

Command reference

Skills CLI

Command reference

Guardrails CLI

Command reference

Evaluation CLI

Command reference

​Quick Start

​All Commands

​Core Commands

​Chat

​Providers

​Global Options

​Environment Variables

​Related

Tools CLI

Providers CLI

Sessions CLI

Memory CLI

Knowledge Base CLI

Skills CLI

Guardrails CLI

Evaluation CLI

Quick Start

All Commands

Core Commands

Chat

Providers

Global Options

Environment Variables

Related