The official client for 🐚
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



The official client for


Seashells is compatible with both Python 2 and Python 3. It's recommended that you use Python 3.

You can install Seashells from PyPI:

pip install seashells


See the instructions on for more information about Seashells. For more information on how to use the command line tool itself, see the built-in help:

seashells --help

Tips and Tricks

  • To easily pipe both stdout and stderr to seashells, you can set up a shell function (source):

    function sea() {
        $* 2>&1 | seashells

Other Clients

Note: other clients are not officially supported.


  1. Update version information.
  2. Build the package using python3 sdist bdist_wheel.
  3. Sign and upload the package using twine upload -s dist/*.


Copyright (c) 2018 Anish Athalye. Released under the MIT License. See LICENSE.rst for details.