Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Command-line client for working with Velociraptor

Project Description


A command-line interface for wrangling Velociraptor swarms and automating some common operations.


This implementation does not rely on any APIs except the conventions of the main HTTP-based interface. It parses and submits forms.


cagey supports several sub-commands, including:

  • build
  • swarm
  • rebuild-all


Simply assemble a build of an app at a given tag. This routine is useful to prime an build before doing other swarm operations.


This routine will invoke the swarm operation on a swarm at a given tag:

cagey swarm MyApp-Recipe_.* 3.0 -x Recipe_Skipped

It takes as its parameters a filter of swarm name, a version number, and optionally some excludes.

The name filter is case sensitive, but the excludes are case insensitive.

When the command is executed, the routine will first report which swarms will be affected and give a 5 second timer in case the matches were not what the user intended. If the routine is not cancelled, it will proceed to swarm each swarm in turn.

Rebuild All

This routine will find swarms matching the filter and peform a forced rebuild, re-release, and swarm on those swarms such that they are rebuilt whether or not Velociraptor believes there’s any advantage to rebuilding. This routine will become largely obviated if Velociraptor issue 19 is implemented.

cagey rebuild-all MyApp
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (9.4 kB) Copy SHA256 Checksum SHA256 Source Oct 17, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting