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

# Eval Results CLI

> Analyze evaluation results via command line

Manage evaluation results from the PraisonAI CLI.

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

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

    class Svc 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"}}
    npx praisonai eval results summary results.json
    ```
  </Step>

  <Step title="With Configuration">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    npx praisonai eval results export results.json --format csv
    ```
  </Step>
</Steps>

# Eval Results CLI

Manage and analyze Agent evaluation results from the command line.

## View Results

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# List all results
npx praisonai eval results list

# Filter by status
npx praisonai eval results list --passed
npx praisonai eval results list --failed

# Filter by category
npx praisonai eval results list --category math
```

## Aggregate Stats

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Show summary
npx praisonai eval results summary

# Show by category
npx praisonai eval results summary --by-category

# Show trend
npx praisonai eval results trend --window 1h
```

## Format Output

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Table format
npx praisonai eval results --format table

# JSON format
npx praisonai eval results --format json

# Markdown format
npx praisonai eval results --format markdown
```

## Export Results

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Export to JSON
npx praisonai eval results export --output results.json

# Export to CSV
npx praisonai eval results export --format csv --output results.csv
```

## Import Results

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Import from file
npx praisonai eval results import results.json

# Merge with existing
npx praisonai eval results import new-results.json --merge
```

## Programmatic (TypeScript)

```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { EvalResults, createEvalResults } from 'praisonai';

const results = createEvalResults();
results.add({ name: 'test', passed: true, score: 0.9, duration: 100 });
console.log(results.formatSummary());
```

## Related

<CardGroup cols={2}>
  <Card title="Eval Results" icon="chart-line" href="/docs/js/eval-results">
    SDK result collection
  </Card>

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