npm install -g praisonai
# or
pnpm add -g praisonai

# Chat with an AI agent
praisonai-ts chat "Hello, how are you?"

# Run with a specific model
praisonai-ts chat "Explain TypeScript" --model openai/gpt-4o

# Get JSON output
praisonai-ts chat "Hello" --json

praisonai-ts chat "Your prompt here"
praisonai-ts chat "Write a poem" --stream
praisonai-ts chat "Hello" --model openai/gpt-4o-mini --json

praisonai-ts run "Analyze this data"
praisonai-ts run "Build a calculator" --agent my-agent.yaml

praisonai-ts workflow workflow.yaml
praisonai-ts workflow workflow.yaml --parallel

praisonai-ts auto "Build a web scraper"
praisonai-ts auto "Create a data pipeline" --pattern sequential

praisonai-ts image generate "A sunset over mountains"
praisonai-ts image analyze https://example.com/image.jpg

praisonai-ts research "What are the latest AI trends?"
praisonai-ts research "TypeScript best practices" --depth 5

praisonai-ts query-rewrite "best programming language"
praisonai-ts query-rewrite "how to learn coding" --strategy expand

praisonai-ts prompt-expand "write a story"
praisonai-ts prompt-expand "create an app" --strategy detail

praisonai-ts context chat "What is TypeScript?"
praisonai-ts context summarize "Long text to summarize..."

praisonai-ts router analyze "Help me debug this code"

praisonai-ts guardrail check "Content to validate"
praisonai-ts guardrail check "Text" --criteria "Must be professional"

praisonai-ts memory list
praisonai-ts memory add "Important information"
praisonai-ts memory search "query"
praisonai-ts memory clear

praisonai-ts session list
praisonai-ts session create my-session
praisonai-ts session get my-session
praisonai-ts session delete my-session
praisonai-ts session export my-session

praisonai-ts knowledge list
praisonai-ts knowledge add document.pdf
praisonai-ts knowledge search "query"

praisonai-ts tools list
praisonai-ts tools info calculator

praisonai-ts skills list
praisonai-ts skills discover ./skills
praisonai-ts skills validate ./my-skill
praisonai-ts skills info my-skill

praisonai-ts mcp list
praisonai-ts mcp add my-server
praisonai-ts mcp start my-server
praisonai-ts mcp stop my-server
praisonai-ts mcp remove my-server

praisonai-ts eval accuracy --input "2+2" --expected "4"
praisonai-ts eval performance --iterations 10
praisonai-ts eval reliability --expected-tools "calculator"

praisonai-ts planning create "My Project Plan"
praisonai-ts planning todo add "Complete documentation"
praisonai-ts planning todo list

praisonai-ts vector info
praisonai-ts vector providers

praisonai-ts db info
praisonai-ts db adapters

praisonai-ts cache info
praisonai-ts cache providers

praisonai-ts graph-rag info

praisonai-ts reranker info
praisonai-ts reranker providers

praisonai-ts telemetry status
praisonai-ts telemetry enable
praisonai-ts telemetry disable
praisonai-ts telemetry clear
praisonai-ts telemetry export

praisonai-ts observability info
praisonai-ts observability providers

praisonai-ts voice info
praisonai-ts voice providers

praisonai-ts handoff info

praisonai-ts providers
praisonai-ts providers --json

praisonai-ts version
praisonai-ts version --json

praisonai-ts help
praisonai-ts help chat
praisonai-ts help --json

{
  "success": true,
  "data": { ... },
  "meta": {
    "duration_ms": 1234,
    "model": "openai/gpt-4o-mini",
    "tokens": { "input": 10, "output": 50 }
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_ARGUMENT",
    "message": "Please provide a prompt"
  }
}