FreeClimb CLI
Install FreeClimb's CLI to start managing apps, buying numbers, and testing applications from your command line.
Read the complete FreeClimb CLI Quickstart documentation for detailed install instructions, how to start using the CLI, and example use cases.
Learn more about FreeClimb, a voice and SMS API built for developers.
Requirements
Node.js version 14.15.0 or higher
Linux users may require further prerequisites. See details about this in the documentation.
Install
From npm
npm install -g freeclimb-cli
Linux users may require further prerequisites. See details about this in the documentation.
Usage
To begin using the FreeClimb CLI:
$ freeclimb login
To see a list of topics, commands, and accompanying explanations:
$ freeclimb help
To explore commands organized under each topic:
$ freeclimb [TOPIC]
To run commands:
$ freeclimb [COMMAND]
Many commands require arguments and also include option flags. To see arguments and option flags for each command, as well as explanations:
$ freeclimb [COMMAND] --help
Review Explore FreeClimb's CLI for more detailed information about usage.
Command Topics
-
freeclimb accounts
- Manage FreeClimb account information -
freeclimb applications
- Manage your account's FreeClimb applications -
freeclimb autocomplete
- Autocomplete installation instructions -
freeclimb available-numbers
- See FreeClimb numbers available for purchase -
freeclimb call-queues
- Manage call queues -
freeclimb calls
- See past calls and make new calls -
freeclimb conference-participants
- Manage and remove conference participants -
freeclimb conferences
- Create and manage conference calls -
freeclimb data
- Find your data directory -
freeclimb help
- Display help information, including a list of topics, commands, and accompanying explanations -
freeclimb incoming-numbers
- Manage your purchased FreeClimb numbers -
freeclimb login
- Log in to FreeClimb with your Account ID and API Key -
freeclimb logout
- Log out and remove your saved FreeClimb Account ID and API Key from your computer's keychain -
freeclimb logs
- Search and filter logs -
freeclimb queue-members
- Manage and remove queue members -
freeclimb recordings
- Find, download, stream, and manage recordings -
freeclimb sms
- See past messages and send new messages
Examples
Review Other Use Cases
Troubleshooting
Newer versions of Node may give an invalid header value error when using the CLI. To resolve this issue:
- Use Node version 14.15.0
- Add NODE_OPTIONS as a persistent environment variable by running the following command:
$ echo export NODE_OPTIONS=--http-parser=legacy >> ~/.bash_profile
$ source ~/.bash_profile
Possible resolutions for "TypeError: cannot read property of undefined":
- Make sure to add NODE_OPTIONS as a persistent environment variable as explained in the section above
- CLI does not have correct write permissions to the OCLIF configuration directory (information about the data directory is here)
Contributing
- Clone this repo
- From the repository root directory, run:
$ npm install -g freeclimb-cli
$ yarn install
- Run ./bin/run from the repository root directory to run the CLI
Feedback & Issues
The FreeClimb CLI is currently in a beta release phase. We are actively working to improve it for all your FreeClimb-related needs. If you would like to give the team feedback or you encounter a problem, please contact support or submit a ticket in the dashboard.