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

# Planning CLI

> CLI commands for planning and todo management in PraisonAI TypeScript

The `praisonai-ts` CLI provides commands for task planning and todo management.

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

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

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

## Quick Start

**1. Simple Usage**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-ts planning create "My Project Plan"
```

**2. With Configuration**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-ts planning create "Build Pipeline" --json
praisonai-ts planning todo add "Complete documentation"
```

## Create Plan

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Create a new plan
praisonai-ts planning create "My Project Plan"

# Get JSON output
praisonai-ts planning create "Build Pipeline" --json
```

## Todo Management

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Add a todo item
praisonai-ts planning todo add "Complete documentation"

# List todo items
praisonai-ts planning todo list

# Get JSON output
praisonai-ts planning todo list --json
```

## SDK Usage

For programmatic planning:

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Plan, PlanStep, TodoList, TodoItem } from 'praisonai';

// Create a plan
const plan = new Plan({ name: 'Build Pipeline' });
plan.addStep(new PlanStep({ description: 'Compile' }));
plan.addStep(new PlanStep({ description: 'Test' }));
plan.addStep(new PlanStep({ description: 'Deploy' }));

// Execute steps
plan.start();
plan.steps[0].start();
plan.steps[0].complete();
console.log('Progress:', plan.getProgress());

// Create todo list
const todos = new TodoList('Tasks');
todos.add(new TodoItem({ content: 'Task 1', priority: 'high' }));
todos.add(new TodoItem({ content: 'Task 2', priority: 'low' }));

// Complete items
todos.items[0].complete();
console.log('Progress:', todos.getProgress());
```

For more details, see the [Planning SDK documentation](https://praison.ai/docs/js/planning.md).

## Related

> [card] [Planning SDK](https://praison.ai/docs/js/planning.md)
>
> Programmatic planning

> [card] [Workflows](https://praison.ai/docs/js/workflows.md)
>
> Orchestrate pipelines


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.