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

# CLI Reference

> PraisonAI TypeScript CLI - Complete command reference

# PraisonAI TypeScript CLI

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

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
npm install -g praisonai
```

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

## CLI Documentation Pages

Each command has dedicated documentation:

* [Tools CLI](/docs/js/tools-cli)
* [Providers CLI](/docs/js/providers-cli)
* [Sessions CLI](/docs/js/sessions-cli)
* [Memory CLI](/docs/js/memory-cli)
* [Knowledge Base CLI](/docs/js/knowledge-base-cli)
* [Skills CLI](/docs/js/skills-cli)
* [Guardrails CLI](/docs/js/guardrails-cli)
* [Evaluation CLI](/docs/js/evaluation-cli)
* [Query Rewriter CLI](/docs/js/query-rewriter-cli)
* [Prompt Expander CLI](/docs/js/prompt-expander-cli)
* [Router Agent CLI](/docs/js/router-agent-cli)
* [Image Agent CLI](/docs/js/image-agent-cli)
* [Deep Research CLI](/docs/js/deep-research-cli)
* [AutoAgents CLI](/docs/js/auto-agents-cli)
* [Workflows CLI](/docs/js/workflows-cli)
* [Planning CLI](/docs/js/planning-cli)
* [Telemetry CLI](/docs/js/telemetry-cli)
* [Observability CLI](/docs/js/observability-cli)
* [Database CLI](/docs/js/database-cli)
* [Cache CLI](/docs/js/cache-cli)
* [Voice CLI](/docs/js/voice-cli)
* [Chunking CLI](/docs/js/chunking-cli)
* [LLM Guardrail CLI](/docs/js/llm-guardrail-cli)