---
sidebar_position: 1
---

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

# CLI Overview

The Lium CLI is a powerful command-line interface that allows you to manage GPU pods directly from your terminal. It provides comprehensive control over pod creation, management, and monitoring without needing to use the web interface.

## Key Features

### Resource Management
- List available GPU nodes with real-time pricing
- Create and manage pods with customizable configurations
- Monitor pod status and resource usage
- Manage multiple pods simultaneously

### File Operations
- Copy files to and from pods
- Synchronize directories with rsync
- Execute commands remotely on pods

### Development Workflow
- SSH access to pods for interactive development
- Template management for common configurations
- Execute commands remotely without SSH

### Provider-side Automation
- Browserless parity with the [provider portal](/providers/portal/overview): portal session, node lifecycle, central-miner-server config, sync, billing, and machine-request queries
- Scripted with `--json` envelopes — see [`lium provider`](./reference/provider.md)

## How It Works

The Lium CLI interacts with the Lium platform through:

- **API Layer**: RESTful API for pod management
- **SDK Integration**: Built on lium-sdk for robust functionality
- **SSH Protocol**: Secure shell access to pods
- **Template System**: Pre-configured Docker templates for common workloads

## Getting Started

To get started with the Lium CLI:

1. **[Installation](./installation)** — Install and configure the CLI
2. **[Quick Start](./quickstart)** — Step-by-step guide for your first pod
3. **[Reference](./reference/)** — Complete reference for every CLI command, grouped by category

## Related

- **[OpenAPI spec](../openapi)** — every REST endpoint the CLI calls under the hood
- **[SDK](../sdk)** — typed Python client packaged with `lium.io`
- **[AI Agents](../agents)** — wire the CLI into a shell-driven agent loop