9cf03e37c4
drop the s, dont remember when i added it it makes more sense and its what the docs have anyway |
||
---|---|---|
.github | ||
assets | ||
cmd/docgen | ||
docs | ||
gallery | ||
golibs | ||
libs | ||
util | ||
.gitignore | ||
.gitmodules | ||
.hilbishrc.lua | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
Makefile | ||
README.md | ||
aliases.go | ||
api.go | ||
exec.go | ||
go.mod | ||
go.sum | ||
lua.go | ||
main.go | ||
preload.lua | ||
rl.go | ||
rl_hilbiline.go | ||
rl_readline-go.go | ||
shell.nix | ||
vars.go | ||
vars_linux.go | ||
vars_windows.go |
README.md
Hilbish is a Unix-y shell which uses Lua for scripting. Things like the prompt, general configuration and such are done with Lua.
For interactive use, it uses a library to run sh which works on all platforms Hilbish can be compiled for. It can also act as a Lua REPL if you want it to be.
Screenshots
Installation
NOTE: Hilbish is currently only officially supported and tested on Linux
Prebuilt binaries
Binaries are provided for the latest commit.
Note that these use Hilbiline, not readline, and may be missing functionality (moving the cursor, proper unicode support and backspace working properly)
Click on the checkmark (or x) near the commit hash, then details for your platform
Then click on the artifacts drop down, and download artifact for your platform,
like what is highlighted in the screenshot.
AUR
Arch Linux users can install Hilbish from the AUR with the following command:
yay -S hilbish
Or from the latest master
commit with:
yay -S hilbish-git
Nixpkgs
Nix/NixOS users can install Hilbish from the central repository, nixpkgs, through the usual ways. If you're new to nix you should probably read up on how to do that here.
Manual Build
Prerequisites
- Go 1.16+
- GNU Readline
On Fedora or other RPM based distros, 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 Arch Linux, it can be installed with:
sudo pacman -S readline
Build
First, clone Hilbish:
git clone --recursive https://github.com/Rosettea/Hilbish
cd Hilbish
go get -d ./...
To build, run:
make dev
Or, if you want a stable branch, run these commands:
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
make build
After you did all that, run sudo make install
to install Hilbish globally.
Contributing
Any kind of contributions to Hilbish are welcome! Read CONTRIBUTING.md before getting started.
Thanks to everyone below who's contributed!
Made with contributors-img.
License
Hilbish is licensed under the MIT license.
Images and assets are licensed under CC-BY-SA 4.0