> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipeline CLI

Pipeline CLI is a Chronosphere-supplied app that lets you manage Chronosphere
Telemetry Pipeline from the command line.

## Get started

To install Pipeline CLI, [Install Pipeline CLI](/ingest/pipeline/pipeline-cli/install).

After you install Pipeline CLI, you'll need to [authenticate](/ingest/pipeline/pipeline-cli/authenticate)
with Chronosphere.

## View command list

To view a full list of available commands and flags, run:

```shell theme={null}
calyptia help
```

You can also prepend `calyptia help` to a specific command to view more information
about that command.

<Note>
  Pipeline CLI supports different commands for Telemetry Pipeline v2 and Telemetry
  Pipeline v3. Depending on whether the [active project](/ingest/pipeline/pipeline-cli/authenticate#view-active-project)
  is a v2 project or a v3 project, running `calyptia help` displays commands relevant
  to that version.
</Note>

## View current version

To view the version of Pipeline CLI that you currently have installed, run
the following command:

```shell theme={null}
calyptia version
```

## Command autocompletion

> This feature is compatible only with v2 projects.

You can add support for shell command autocompletion with Pipeline CLI for Bash,
Zsh, Fish, and PowerShell by using the `calyptia completion` command.

This section provides detailed steps for Bash and Zsh on macOS. For Linux-specific
details and instructions for Fish and PowerShell, see the output of
`calyptia completion --help`.

<Tabs>
  <Tab title="Bash" id="autocomplete-bash">
    1. Update or install `bash-completion`:

       ```shell theme={null}
       brew install bash-completion
       ```

    2. In a shell initialization script, such as `~/.bashrc`, add the following:

       ```shell theme={null}
       source "$(brew --prefix bash-completion)/etc/bash_completion"
       eval "$(calyptia completion bash)"
       ```

    3. Restart the shell.
  </Tab>

  <Tab title="Zsh" id="autocomplete-zsh">
    1. Go to your Zsh `site-functions` folder.

       * If you installed Zsh with Homebrew, the path is
         `/opt/homebrew/share/zsh/site-functions`.
       * If you use the default macOS Zsh, the path is
         `/usr/local/share/zsh/site-functions`.

    2. Run the following command:

       ```shell theme={null}
       calyptia completion zsh > _calyptia
       ```

    3. Ensure your `~/.zshrc` file has
       [`compinit`](https://zsh.sourceforge.io/Doc/Release/Completion-System.html) added.
       If you use `oh-my-zsh`, it adds that for you.

    4. Restart the shell.
  </Tab>
</Tabs>

You can now press `Tab` on the command line to automatically complete
Pipeline CLI commands.