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:| 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 version | Display the CLI version |
serval help | Show help for any command |
serval completion | Generate shell autocompletion scripts |
Getting Started
- Install the Serval CLI
- Run
serval loginto authenticate - Use
serval pull <team-prefix>to download your team’s workflows - Edit workflows locally
- Use
serval push <team-prefix>to deploy your changes
Next Steps
- Learn how to install the CLI
- Understand pushing and pulling configuration