Commands

The Playbooks CLI comes with the following commands:


Account

Display which account is currently active.

playbooks account playbooks account --select 'id,name,email'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Add

Add a play to your local project and run install commands.

playbooks add <uuid> playbooks add <uuid> --path ~/path/to/folder
Available options
Option
Type
Description
--pathstringPath to custom destination folder
--namestringCustom name for the directory
--versionstringSpecify a specific version to add

Banks

View your account bank accounts.

playbooks banks playbooks banks --select 'id,summary,createdAt'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Cards

View your account credit cards.

playbooks cards playbooks cards --select 'id,summary,createdAt'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Clone

Clone a play to your Github account.

playbooks clone <uuid> playbooks clone <uuid> --account playbooks-community --name my-cloned-play
Available options
Option
Type
Description
--accountstringClone to a specific account
--namestringRename the cloned playsitory
--privatebooleanMark the cloned playsitory as private
--versionstringSpecify the versionId

Download

Download a play to your local machine.

playbooks download <uuid> playbooks download <uuid> --path '~/path/to/folder' playbooks download <uuid> --version 'v1.0.0'
Available options
Option
Type
Description
--pathstringPath to custom destination folder
--namestringCustom name for the download
--versionstringSpecify the versionId

Downloads

View your account downloads.

playbooks downloads playbooks downloads --select 'id,status,createdAt'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Login

Login to Playbooks account using email / password.

playbooks login playbooks login --email acme@example.com --password ******
Available options
Option
Type
Description
--emailstringYour email address
--passwordstringYour password

Logout

Logout of your Playbooks account.

playbooks logout

Oauth

Login to Playbooks via Github OAuth.

playbooks oauth

Payouts

View your account payouts.

playbooks payouts playbooks payouts --select 'id,amount,createdAt'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Ping

Test your connection to the Playbooks API.

playbooks ping

Play

Fetch and display a specific play

playbooks play <uuid> playbooks play <uuid> --select 'id,name,uuid,tagline'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Plays

Fetch and display a list of plays

playbooks plays playbooks plays --select 'id,name,uuid,tagline' playbooks plays --framework 'react' playbooks plays --language 'typescript' playbooks plays --platform 'web' playbooks plays --tool 'stripe' playbooks plays --tag 'portfolio' playbooks plays --user 'ehubbell' playbooks plays --view 'featured'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display
--frameworkstringFetch by framework identifier
--languagestringFetch by language identifier
--platformstringFetch by platform identifier
--teamstringFetch by team identifier
--toolstringFetch by tool identifier
--tagstringFetch by tag identifier
--userstringFetch by user identifier
--viewenumFetch by view

Session

Fetch and display your current session

playbooks session playbooks session --select 'id,name,uuid,email'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Subscription

Fetch and display your account subscription

playbooks subscription playbooks subscription --select 'id,name,uuid,email'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Teams

Fetch and display your account teams

playbooks teams playbooks teams --select 'id,name,uuid,email'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Toggle

Toggle your active account.

playbooks toggle playbooks toggle --uuid 'playbooks-community'
Available options
Option
Type
Description
--uuidstringAccount identifier

Transfers

View your incoming account transfers.

playbooks transfers playbooks transfers --select 'id,amount,createdAt'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display

Usage

Fetch and display your account usage statistics

playbooks usage playbooks usage --select 'id,totalCredits,totalRemaining'
Available options
Option
Type
Description
--selectstring[]A comma separated list of fields you'd like to display