Skip to content


Repository files navigation


xonsh is a Python-powered, cross-platform, Unix-gazing shell language and command prompt.

The language is a superset of Python 3.6+ with additional shell primitives. xonsh (pronounced conch) is meant for the daily use of experts and novices alike.

What is xonsh?

If you like xonsh, ⭐ the repo, write a tweet and stay tuned by watching releases.

Join to

GitHub Actions

First steps

Install xonsh from pip:

python -m pip install 'xonsh[full]'

And visit for more information:


Xonsh has an extension/plugin system. We call these additions xontribs.

Projects that use xonsh or compatible

  • gitsome: Supercharged Git/shell autocompleter with GitHub integration.
  • xxh: Using xonsh wherever you go through the SSH.
  • rever: Cross-platform software release tool.
  • Regro autotick bot: Regro Conda-Forge autoticker.
  • zoxide: A smarter cd command.
  • any-nix-shell: xonsh support for the nix run and nix-shell environments of the Nix package manager.

Jupyter-based interactive notebooks via xontrib-jupyter:

  • Jupyter and JupyterLab: Interactive notebook platform.
  • euporie: Terminal based interactive computing environment.
  • Jupytext: Clear and meaningful diffs when doing Jupyter notebooks version control.

The xonsh shell community

The xonsh shell is developed by a community of volunteers. There are a few ways to help out:

We welcome new contributors!


  • Thanks to Zulip for supporting the xonsh community!