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

# Serval CLI Overview

> Command-line interface for managing Serval workflows and configuration

# Serval CLI Overview

The Serval CLI is a powerful command-line tool that enables you to manage your Serval workflows and configurations locally. With the CLI, you can pull workflows from your Serval teams, edit them in your preferred development environment, and push changes back to Serval.

<Warning>
  The Serval CLI is currently in **beta**. While the core functionality is stable, some features and APIs may change as we continue to improve the tool based on user feedback.
</Warning>

## Key Features

* **Pull and Push Workflows**: Download workflows from your Serval teams to edit locally and push changes back
* **Version Control Integration**: Manage your workflows in Git or other version control systems
* **Team-based Organization**: Work with multiple teams and their respective workflows
* **Secure Authentication**: OAuth-based device authentication flow

## Available Commands

The Serval CLI provides the following commands:

| Command                             | Description                                          |
| ----------------------------------- | ---------------------------------------------------- |
| `serval login`                      | Authenticate with the Serval platform                |
| `serval logout`                     | Log out from the Serval platform                     |
| `serval status`                     | Show current authentication status                   |
| `serval pull <team-prefix>`         | Pull workflows and configuration for a specific team |
| `serval push <team-prefix>`         | Push local changes back to a team                    |
| `serval access search [query]`      | Browse roles available to request access to          |
| `serval access request`             | Submit an access request for a role                  |
| `serval access list`                | View your access requests                            |
| `serval access cancel <request-id>` | Cancel or revoke an access request                   |
| `serval version`                    | Display the CLI version                              |
| `serval help`                       | Show help for any command                            |
| `serval completion`                 | Generate shell autocompletion scripts                |

## Getting Started

1. [Install the Serval CLI](/sections/cli/installation)
2. Run `serval login` to authenticate
3. Use `serval pull <team-prefix>` to download your team's workflows
4. Edit workflows locally
5. Use `serval push <team-prefix>` to deploy your changes

## Next Steps

* Learn how to [install the CLI](/sections/cli/installation)
* Understand [pushing and pulling configuration](/sections/cli/push-pull-configuration)
* Manage [access requests from the CLI](/sections/cli/access)