getstream-cli

Stream CLI

Note: The Stream CLI is currently in beta and may contain bugs. This should not be used against a production environment at this time. To report bugs, please follow the instructions below. Thank you for your support!

Stream's Command Line Interface (CLI) makes it easy to create and manage your Stream apps directly from the terminal. Currently, only Chat is supported; however, the ability to manage Feeds will be coming soon.

🗒 Issues

If you're experiencing problems directly related to the CLI, please add an issue on GitHub.

For other issues, submit a support ticket.

📚 Changelog

As with any project, things are always changing. If you're interested in seeing what's changed in the Stream CLI, the changelog for this project can be found here.

🏗 Installation

The Stream CLI is easy to install. You have the option to use homebrew (preferred) if you're on macOS, download a single binary for your OS of choice, or download via npm.

Homebrew

$ brew install stream

NPM

$ npm install -g getstream-cli

Binaries

• Mac OS X
• Linux
• Windows

Note: Binaries are generally updated less frequently than Homebrew.

🚀 Getting Started

In order to initialize the CLI, please have your Stream API key and secret ready. Run the following command:

$ stream config:set

You will then be prompted to enter your API key and secret.

$ ? What's your API key? 🔒
$ ? What's your API secret? 🔒

Now, you're good to go!

$ Your config has been generated! 🚀

Note: Your API key and secret can be found on the Stream Dashboard and is specific to your application.

🔨 Syntax

Basic commands use the following syntax:

$ stream command:COMMAND --arg1 "foo" --arg2 "bar"

Whereas commands for specific products use subcommands:

$ stream command:COMMAND:SUBCOMMAND --arg1 "foo" --arg2 "bar"

🥳‍ Usage

$ npm install -g getstream-cli
$ stream COMMAND
running command...
$ stream (-v|--version|version)
getstream-cli/0.0.1-beta.17 darwin-x64 node-v10.15.1
$ stream --help [COMMAND]
USAGE
  $ stream COMMAND
...

💻 Commands

• stream autocomplete - display autocomplete installation instructions
• stream chat - configure and manage all things related to chat
• stream commands - list all the commands
• stream config - manage config variables
• stream help - display help for stream

📣 Feedback

If you have any suggestions or just want to let us know what you think of the Stream CLI, please send us a message at [e-mail] or create a GitHub Issue.