Skip to main content

Serval CLI Overview

The Serval CLI is a powerful command-line tool that enables you to manage your Serval workflows, skills, and configurations locally. With the CLI, you can pull workflows and skills from your Serval workspaces, 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 and Skills: Download workflows and Help Desk and Catalyst skills from your Serval workspaces to edit locally and push changes back
  • Version Control Integration: Manage your workflows and skills in Git or other version control systems
  • Workspace-based Organization: Work with multiple workspaces and their respective workflows
  • Secure Authentication: OAuth-based device authentication flow
  • Run Simulations: Launch simulation configs and suites and block on the result, so a pipeline can gate on them

Available Commands

The Serval CLI provides the following commands:

Getting Started

  1. Install the Serval CLI
  2. Run serval login to authenticate
  3. Use serval pull <team-prefix> to download your workspace’s workflows and skills
  4. Edit workflows and skills locally
  5. Use serval push <team-prefix> to deploy your changes

Next Steps