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

​
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:
CommandDescription
serval loginAuthenticate with the Serval platform
serval logoutLog out from the Serval platform
serval statusShow 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 versionDisplay the CLI version
serval helpShow help for any command
serval completionGenerate shell autocompletion scripts

​
Getting Started

  1. Install the Serval CLI
  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