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

# praisonai uninstall

> Cleanly remove the managed PraisonAI CLI install via the detected tool manager

`praisonai uninstall` removes the managed CLI install and its global `praisonai` shim, confirming first unless you pass `--yes`.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    A[praisonai uninstall]:::agent --> B{--yes?}:::config
    B -->|No| C[Confirm prompt]:::process
    B -->|Yes| D[Detect manager]:::tool
    C --> D
    D --> E[uv / pipx / pip uninstall]:::tool
    E --> F[Removed]:::success

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff
    classDef process fill:#F59E0B,stroke:#7C90A0,color:#fff
    classDef success fill:#10B981,stroke:#7C90A0,color:#fff
    classDef config fill:#6366F1,stroke:#7C90A0,color:#fff
```

## Quick Start

<Steps>
  <Step title="Remove interactively">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai uninstall
    ```

    Asks `Remove PraisonAI X.Y.Z (installed via uv)? [y/N]`, then removes via the detected manager.
  </Step>

  <Step title="Remove without a prompt (CI)">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai uninstall --yes
    ```

    Skips confirmation — the CI-safe form. `-y` is the short alias.
  </Step>
</Steps>

***

## How It Works

`praisonai uninstall` detects how the CLI was installed and runs the matching removal command.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
    participant User
    participant CLI as praisonai
    participant Manager as uv / pipx / pip

    User->>CLI: praisonai uninstall
    CLI-->>User: "Remove PraisonAI 4.6.145 (installed via uv)? [y/N]"
    User->>CLI: y
    CLI->>Manager: uv tool uninstall praisonai
    Manager-->>CLI: removed
    CLI-->>User: "PraisonAI 4.6.145 removed."
```

| Detected manager        | Uninstall command             |
| ----------------------- | ----------------------------- |
| `uv`                    | `uv tool uninstall praisonai` |
| `pipx`                  | `pipx uninstall praisonai`    |
| `pip` (library install) | `pip uninstall -y praisonai`  |

<Note>
  This is **CLI self-management only** — `praisonaiagents` (the SDK) is **not** removed by this command.
</Note>

***

## Options

| Flag          | Description                                        |
| ------------- | -------------------------------------------------- |
| `--yes`, `-y` | Skip the confirmation prompt (non-interactive/CI). |

### JSON output

Add `--output json` for machine-readable output.

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{"manager": "uv", "removed": "4.6.145"}
```

<Warning>
  JSON mode never prompts. It proceeds as if `--yes` were passed, so only use `--output json` when you intend to remove without confirmation.
</Warning>

***

## Common Patterns

Remove in a CI teardown step.

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai uninstall --yes
```

Capture the result for a report.

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai uninstall --yes --output json
```

***

## Non-Managed Installs

When automatic uninstall isn't supported for the detected manager, PraisonAI prints a clear error and exits non-zero.

```
Automatic uninstall is not supported for a 'pip' install.
Remove manually with: pip uninstall praisonai
```

***

## Best Practices

<AccordionGroup>
  <Accordion title="Use --yes only in automation">
    Keep the confirmation prompt on for interactive use. Reach for `--yes` (or `-y`) only in CI teardown or scripted fleet removal.
  </Accordion>

  <Accordion title="Uninstall removes the CLI, not the SDK">
    If you embed `praisonaiagents` in your own app, `praisonai uninstall` leaves it intact. Remove the SDK separately with `pip uninstall praisonaiagents`.
  </Accordion>

  <Accordion title="Let the detected manager do the work">
    The command runs the same manager that installed the CLI, so the isolated `uv tool` / `pipx` environment is removed cleanly without leftover shims.
  </Accordion>
</AccordionGroup>

***

## Related

<CardGroup cols={2}>
  <Card title="praisonai upgrade" icon="arrow-up" href="/docs/features/praisonai-upgrade">
    Update the CLI in place
  </Card>

  <Card title="Update Hint" icon="bell" href="/docs/features/praisonai-update-hint">
    Non-blocking "update available" notice
  </Card>

  <Card title="Installer Internals" icon="gear" href="/docs/install/installer">
    How install.sh provisions the CLI
  </Card>

  <Card title="Quick Install" icon="bolt" href="/docs/install/quickstart">
    One-liner install
  </Card>
</CardGroup>