quixio / quix-cli

Quix Command Line Interface (CLI)

⚠️ WARNING: Internal Use Only & Work In Progress ⚠️

This repository is intended for internal use only and is currently a work in progress. Features and documentation may be incomplete or subject to change. Please ensure you have the necessary permissions and understand the implications of using unreleased or unstable features.

Welcome to Quix CLI, your powerful command-line companion for seamlessly managing and interacting with the features of our Quix Cloud product. While Quix offers a robust Frontend UI for a user-friendly experience, the CLI empowers you with efficiency and flexibility, allowing you to streamline your workflow and take control from the command line.

• Effortless Control: Execute commands effortlessly to manage various aspects of your Quix organisation.

• Script Automation: Integrate Quix operations into your scripts for automated workflows and enhanced productivity.

• Accessibility: Access and manipulate Quix features directly from the command line, providing an alternative interface for users who prefer terminal-based interactions.

• Scalability: Seamlessly scale your Quix operations, whether you are working on a single instance or orchestrating tasks across multiple environments.

Quix CLI is designed to be intuitive, consistent, and respectful of user preferences following CLI design best practices.

For more information and detailed documentation, visit quix.io.

Installation of Quix CLI

To install the Quix CLI, users have multiple methods depending on their operating system. Here's an expanded installation section including the main ways to install Quix CLI on Linux, macOS, and Windows.

For macOS:

• Install latest version:

  curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash

• Install with explicit version:

  curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash -s -- -v={version}

For Linux:

• Install latest version:

  curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash

• Install with explicit version:

  curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash -s -- -v={version}

For Windows (PowerShell):

• Install latest version:

  iwr https://github.com/quixio/quix-cli/raw/main/install.ps1 -useb | iex

• Install with explicit version:

  $quixCliInstall = (iwr https://github.com/quixio/quix-cli/raw/main/install.ps1 -useb).Content; $version="{version}"; iex "$quixCliInstall"

Notes

• Version Specification: Replace {version} with the actual version number you intend to install (e.g., 1.2.3). Omitting the {version} parameter will automatically default to installing the latest available version of Quix CLI. You have the option to install the latest version or specify a particular version according to your needs. To view and choose from all available versions, visit the releases section.
• PATH Verification: After installation, ensure that the directory where Quix CLI is installed is included in your system's PATH.

Installation using release binaries

1. Go to the release page and dowload the executable matching your OS/architecture.
2. Copy the executable to a location of your choice.
3. Add the location to your system's PATH.

Installation via Dotet Global tools

dotnet tool install --global QuixCLI --prerelease

Usage

in order to get a list of available commands run:

quix --help

Login

You have 2 ways of logging in:

1. Interactive login

quix login

This will open the browser in order to complete the login.

2. PAT Token

quix login <patToken>

Get Started

After setting up your context and logging in you will be able to access your Quix organisation. For more information visit Quix Docs.

Using dedicated Quix clusters

The CLI will use the Serverless platform as the default context: https://portal-api.platform.quix.io/

For Dedicated or BYOC Quix clusters you can add your own context by running:

quix contexts add <name> <portalEndpoint>

Select it using the following command:

quix contexts use <name>

Need help?

If you run into any problems, please create an issue or ask in #quix-help in our Quix Community on Slack.

Community 👭

Join other software engineers in The Stream, an online community of people interested in all things data streaming. This is a space to both listen to and share learnings.

🙌 Join our Slack community!

Stay in touch 👋

You can follow us on Twitter and Linkedin where we share our latest tutorials, forthcoming community events and the occasional meme.

If you have any questions or feedback - write to us at [e-mail]!