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

# CLI Overview

> CatOps CLI - lightweight monitoring agent

CatOps CLI is a free, lightweight monitoring agent that runs on your servers. Use it standalone or connect to Cloud for dashboards and alerts.

## Features

<CardGroup cols={2}>
  <Card title="System Metrics" icon="chart-line">
    CPU, memory, disk, network - updated in real-time
  </Card>

  <Card title="Process Monitoring" icon="microchip">
    See which processes consume the most resources
  </Card>

  <Card title="Service Detection" icon="gears">
    Auto-detect nginx, PostgreSQL, Redis, Docker
  </Card>

  <Card title="AI Assistant" icon="robot">
    Ask "why is CPU high?" and get intelligent answers
  </Card>

  <Card title="Telegram Alerts" icon="bell">
    Get notified when thresholds are exceeded
  </Card>

  <Card title="Auto-start" icon="play">
    Runs automatically on boot
  </Card>
</CardGroup>

## Quick Install

```bash theme={null}
curl -fsSL https://get.catops.app/install.sh | bash
```

<Warning>
  Don't use `sudo`. The CLI installs to your home directory.
</Warning>

## Basic Usage

```bash theme={null}
# Check server status
catops status

# View top processes
catops processes

# Ask AI about your server
catops ask "why is memory high?"

# Check configuration
catops config
```

## Standalone vs Cloud Mode

| Mode           | Features                                      |
| -------------- | --------------------------------------------- |
| **Standalone** | Local metrics, terminal UI, no account needed |
| **Cloud**      | Dashboard, alerts, AI, history, multi-server  |

### Enable Cloud Mode

```bash theme={null}
catops auth login YOUR_TOKEN
catops service install && catops service start
```

Get your token at [catops.app/settings](https://catops.app/settings).

## CLI vs Hub

|                  | CLI        | Hub           |
| ---------------- | ---------- | ------------- |
| **Interface**    | Terminal   | Web dashboard |
| **Price**        | Free       | \$5-99        |
| **Multi-server** | Via Cloud  | Built-in      |
| **Docker**       | View only  | Full control  |
| **Data storage** | Cloud/None | Local         |

## System Requirements

* Linux (x86\_64, ARM64, ARM)
* macOS (Intel, Apple Silicon)
* FreeBSD (x86\_64)

No root required. Installs to `~/.local/bin`.

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/cli/installation">
    Detailed installation guide
  </Card>

  <Card title="Commands" icon="terminal" href="/cli/commands">
    Full command reference
  </Card>

  <Card title="Cloud Mode" icon="cloud" href="/cli/cloud-mode">
    Connect to Cloud dashboard
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/cli/installation#troubleshooting">
    Common issues and fixes
  </Card>
</CardGroup>