> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Reference

> PraisonAI TypeScript CLI - Complete command reference

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

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    User([User]) --> CLI[CLI]
    CLI --> Agent[Agent]

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff

    class Agent agent
    class User,CLI tool
    classDef agent fill:#8B0000,color:#fff
    classDef tool fill:#189AB4,color:#fff

```

## Quick Start

<Steps>
  <Step title="Simple Usage">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    npm install -g praisonai
    praisonai-ts chat "Hello"
    ```
  </Step>

  <Step title="With Configuration">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    export OPENAI_API_KEY=your-key
    praisonai-ts chat "Explain AI" --model openai/gpt-4o-mini
    ```
  </Step>
</Steps>

***

***

## 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

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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
```

## Related

<CardGroup cols={2}>
  <Card title="Tools CLI" icon="terminal" href="/docs/js/tools-cli">
    Command reference
  </Card>

  <Card title="Providers CLI" icon="terminal" href="/docs/js/providers-cli">
    Command reference
  </Card>

  <Card title="Sessions CLI" icon="terminal" href="/docs/js/sessions-cli">
    Command reference
  </Card>

  <Card title="Memory CLI" icon="terminal" href="/docs/js/memory-cli">
    Command reference
  </Card>

  <Card title="Knowledge Base CLI" icon="terminal" href="/docs/js/knowledge-base-cli">
    Command reference
  </Card>

  <Card title="Skills CLI" icon="terminal" href="/docs/js/skills-cli">
    Command reference
  </Card>

  <Card title="Guardrails CLI" icon="terminal" href="/docs/js/guardrails-cli">
    Command reference
  </Card>

  <Card title="Evaluation CLI" icon="terminal" href="/docs/js/evaluation-cli">
    Command reference
  </Card>
</CardGroup>