Hilbish/README.md

2.8 KiB

Hilbish

🎀 a nice lil shell for lua people made with go and lua

help wanted

Hilbish is an interactive Unix-like shell written in Go, with the config and other code written in Lua.
It is sort of in a stable state currently, usable as a daily shell, but there may still be breaking changes in Lua modules.

Screenshots





Links

Building

Prebuilt binaries are not yet provided, so to try it out you'll have to manually compile.

NOTE: Hilbish is currently only officially supported and tested on Linux

Prerequisites

On Fedora, readline can be installed with:

sudo dnf install readline-devel

On Debian/Ubuntu and distros based on them, it can be installed with:

sudo apt install libreadline-dev

On OpenSUSE, it can be installed with:

sudo zypper install readline-devel

Install

First, clone Hilbish:

git clone --recursive https://github.com/Hilbis/Hilbish
cd Hilbish

Then build and install:

make dev
sudo make install
# Or 
sudo make all

Or, if you want the latest stable release:

git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
make build
sudo make install

Alternatively, if you use Arch Linux, you can compile Hilbish with an (unofficial) AUR package:

yay -S hilbish

If you want the latest and greatest, you can install and compile from latest git commit:

yay -S hilbish-git

Uninstall

sudo make uninstall

Contributing

Any kind of contributions to Hilbish are welcome!
Make sure to read CONTRIBUTING.md before getting started.

Special Thanks To

Everyone here who has contributed:

Made with contributors-img.

Credits

  • This blog post which is how Hilbish now inserts a newline even if output doesn't have one.

License

Hilbish is licensed under the MIT license.
Read here for more info.