This software is in pre-release status and not currently supported. We are looking for community feedback on what type of CLI tool would be the most useful for Twilio users.
⚠⚠⚠⚠
- Node.js >= 8.0
- Running on Linux? Depending on your distribution, you will need to run the following command:
Debian/Ubuntu:sudo apt-get install libsecret-1-dev
Red Hat-based:sudo yum install libsecret-devel
Arch Linux:sudo pacman -S libsecret
Eventually, the plan is to have self-contained packages for *nix systems and an installer for Windows with no need for manually installing prerequisites.
You can install twilio-cli
via npm or Homebrew (macOS or Linux).
- Install the CLI globally:
npm install -g twilio-cli
- Now you can run the CLI from anywhere using the
twilio
command.
brew tap twilio/brew && brew install twilio
- Now you can run the CLI from anywhere using the
twilio
command.
- Check if there's a new version:
npm outdated -g twilio-cli
- Update the CLI globally:
npm update -g twilio-cli
twilio-cli
uses a modified version of Semantic Versioning for all changes. See this document for details.
twilio login
This is for caching your credentials for your existing Twilio account (aka Project) locally. You will be prompted for a shorthand identifier for your Twilio project. This is referred to as the "project ID", which is just an easy to remember, short string to identify the project. (If you've used git
before, it's like the name you assign to a remote like "origin".)
Note, while you are prompted for your Account SID and Auth Token, these are not saved. An API Key is created (look for "twilio-cli for [username] on [hostname]" in the console) and stored in your system's keychain.
For details on how to work with multiple Twilio accounts/projects or use environment variables, see the projects section.
twilio
Lists all available commands.
twilio phone-numbers:list
Lists all your phone numbers.
Add --help
to any command to get help (e.g. twilio phone-numbers:list --help
)
See the General usage guide.
- Clone this repo.
- From the repo directory, run:
npm install
- Run
./bin/run
from the repo directory to run the CLI.
Please file a GitHub issue in this repository for any feedback you may have.
MIT