A cli command checking the available executors on your browserstack subscription.
Browserstack supports limited number of queued tasks. If you run a test when the queue is already full, the test will fail. This command helps you check if it is possible to run a new test. If you have reached the upper limit of allowed parallel tests, the command will wait until an executor becomes available.
Just install the package as a global package on your system
npm install -g browserstack-guard
Before you run any test on browserstack, run the following command:
browserstack-guard --username <user name> --accesskey <access key>
or
BROWSERSTACK_USERNAME=<user name> BROWSERSTACK_ACCESS_KEY=<access key> browserstack-guard
This could be very handy to run before you start any automated test in the build pipeline.
Pull requests are welcome for fixing issues or adding more features. Things that could be useful are unit tests and more safety nets for when something goes wrong.