Merge branch 'main' of github.com:Alexandre1a/GoSH

I forgot to pull before editing the README
This commit is contained in:
Alexandre 2025-02-02 22:41:30 +01:00
commit e64ed1373c

View File

@ -13,21 +13,28 @@ If not, the issue will be fixed soon (in case of a typo for example)
## Installation ## Installation
You can grab the binaries for your system and architecture, or build it yourself You can grab the binaries for your system and architecture, or build it yourself
To build it, clone the repository, cd into it and run To build it, clone the repository, cd into it and run
'go build -o bin/GoSH' `go build -o bin/GoSH`
To test the shell and see if it suits you. To test the shell and see if it suits you.
If everything works, then move the binary to a place inside your path. If everything works, then move the binary to a place inside your path.
To directly install it with the Go toolchain, just use 'go intall' To directly install it with the Go toolchain, just use
This will build and place the binary inside your $HOME/go/bin folder. `go intall`
This will build and place the binary inside your `$HOME/go/bin` folder.
Add this folder to your path and you are good to go ! Add this folder to your path and you are good to go !
## Usage ## Usage
To use the program, just invoke it with 'GoSH' To use the program, just invoke it with `GoSH`
If you see a message about a config file, create '~/.config/gosh/gosh_config.toml' and populate it with the defaults written inside this repo. If you see a message about a config file, create `~/.config/gosh/gosh_config.toml` and populate it with the defaults written inside this repo -> [here](/defaults.toml).
To change config parameter on the fly, use the 'set' builtin. To change config parameter on the fly, use the `set` builtin.
Currently, 'set' has a limited amount of configuration options. Currently, `set` has a limited amount of configuration options and need to have a valid config file to write to.
To change the color of the prompt use 'set color <color>' To change the color of the prompt use `set color <color>`
You can use all "console colors", listed [https://gist.github.com/kamito/704813 | here] You can change the history size with `set history_size <int>`
You can change the prompt with `set prompt <promp>`
Here is some exemple of prompts :
- `[{dir}] > `
- `["Hello World"] $ `
- `"Hello" `
You can use all "console colors", listed [here](https://gist.github.com/kamito/704813)
## Know Issues ## Know Issues
Currently there is a number of known or unkwown issues. Currently there is a number of known or unkwown issues.