================= The CrateDB Shell

.. image:: https://github.com/crate/crash/actions/workflows/main.yml/badge.svg :target: https://github.com/crate/crash/actions/workflows/main.yml :alt: Outcome of CI

.. image:: https://img.shields.io/pypi/v/crash.svg :target: https://pypi.python.org/pypi/crash :alt: Most recent version on PyPI

.. image:: https://img.shields.io/pypi/pyversions/crash.svg :target: https://pypi.python.org/pypi/crash :alt: Supported Python versions

.. image:: https://img.shields.io/github/license/crate/crash :target: https://github.com/crate/crash/blob/main/LICENSE :alt: License

.. image:: https://static.pepy.tech/badge/crash/month :target: https://www.pepy.tech/projects/crash :alt: Number of downloads per month

|

The CrateDB Shell (aka Crash) is an interactive command-line interface_ (CLI) tool for interacting with CrateDB.

Screenshot

.. image:: https://raw.githubusercontent.com/crate/crash/main/docs/query.png :alt: A screenshot of Crash

Documentation

The official documentation is available at CrateDB shell documentation_.

Installation

Python Package

Crash is available as a package from PyPI.

To install the most recent version, run::

pipx install crash

Now, run it::

crash

Troubleshooting

The documentation section about troubleshooting connection errors_ provides support and guidelines how to debug and resolve problems when connecting to CrateDB_ or CrateDB Cloud_.

Contributing

This project is primarily maintained by Crate.io_, but we welcome community contributions!

See the developer docs_ and the contribution docs_ for more information.

Help

Looking for more help? Check out our support channels_.

.. _command-line interface: https://en.wikipedia.org/wiki/Command-line_interface .. _contribution docs: CONTRIBUTING.rst .. _Crate.io: https://cratedb.com/ .. _CrateDB: https://github.com/crate/crate .. _CrateDB Cloud: https://console.cratedb.cloud .. _CrateDB shell documentation: https://cratedb.com/docs/crate/crash/ .. _developer docs: DEVELOP.rst .. PATH: https://en.wikipedia.org/wiki/PATH(variable) .. _pip: https://pypi.python.org/pypi/pip .. _support channels: https://cratedb.com/support/ .. _troubleshooting connection errors: https://cratedb.com/docs/crate/crash/en/latest/troubleshooting.html