2021-03-11 07:42:00 -07:00
|
|
|
#+TITLE: ohmyksh
|
|
|
|
|
|
2020-07-15 16:28:24 -06:00
|
|
|
Have your cake and eat it too!
|
|
|
|
|
|
|
|
|
|
~ohmyksh~ is a framework for expanding OpenBSD's [[https://man.openbsd.org/ksh][ksh]]. It offers:
|
|
|
|
|
|
2021-03-11 09:29:03 -07:00
|
|
|
- completions :: for common things like [[https://man.openbsd.org/man][man]] pages, [[https://man.openbsd.org/ssh][ssh]] ~known_hosts~ and ~git~ (and
|
|
|
|
|
~got~!) commands.
|
2020-07-15 16:28:24 -06:00
|
|
|
- extensions :: to import bulk functionality, including git-prompt, OpenBSD
|
|
|
|
|
specific tooling, disabling color.. etc.
|
2021-03-11 09:29:03 -07:00
|
|
|
- prompts :: a decent selection of useful, minimal prompts.
|
|
|
|
|
|
2020-07-15 16:28:24 -06:00
|
|
|
|
|
|
|
|
** Completions
|
|
|
|
|
|
2020-07-19 08:07:12 -06:00
|
|
|
| Name | Completes |
|
|
|
|
|
|--------+------------------------------------|
|
2021-03-10 16:59:52 -07:00
|
|
|
| [[file:completions/git.org][git]] | add, fetch... |
|
|
|
|
|
| [[file:completions/got.org][got]] | add, blame... |
|
|
|
|
|
| [[file:completions/gopass.org][gopass]] | audit, config... |
|
|
|
|
|
| [[file:completions/man.org][man]] | man pages |
|
|
|
|
|
| [[file:completions/mpc.org][mpc]] | play, load, toggle... |
|
|
|
|
|
| [[file:completions/rc.org][rc]] | OpenBSD rc scripts and rc commands |
|
|
|
|
|
| [[file:completions/ssh.org][ssh]] | ssh known hosts |
|
|
|
|
|
| [[file:completions/vmd.org][vmd]] | vmctl commands and VM names |
|
2020-07-15 16:28:24 -06:00
|
|
|
|
|
|
|
|
** Extensions
|
|
|
|
|
|
2020-08-24 08:02:24 -06:00
|
|
|
| Name | Description |
|
|
|
|
|
|------------+--------------------------------------------------------------|
|
2021-03-10 16:59:52 -07:00
|
|
|
| [[file:extensions/fonts.org][fonts]] | Load fonts from common locations. |
|
|
|
|
|
| [[file:extensions/fzf.org][fzf]] | - |
|
|
|
|
|
| [[file:extensions/git-prompt.org][git-prompt]] | A port of git-prompt for KSH. |
|
|
|
|
|
| [[file:extensions/got.org][got]] | Adds PS1 support for got, as well as a few helper functions. |
|
|
|
|
|
| [[file:extensions/k.org][k]] | A tool to quickly change directories. |
|
|
|
|
|
| [[file:extensions/nocolor.org][nocolor]] | Disable terminal color options for many tools. |
|
|
|
|
|
| [[file:extensions/openbsd.org][openbsd]] | A set of tools for working with the OpenBSD source trees. |
|
2020-07-15 16:28:24 -06:00
|
|
|
|
|
|
|
|
|
|
|
|
|
** Prompts
|
|
|
|
|
|
2020-07-19 08:26:26 -06:00
|
|
|
| Name | Example | Extensions used |
|
|
|
|
|
|------------+--------------------------------+-----------------|
|
2021-03-10 16:59:52 -07:00
|
|
|
| [[file:prompts/q.org][q]] | ~qbit@litr[0]:~$~ | git-prompt, got |
|
|
|
|
|
| [[file:prompts/plain.org][plain]] | ~litr:~/src/ohmyksh/prompts$~ | - |
|
|
|
|
|
| [[file:prompts/og-openbsd.org][og-openbsd]] | ~$~ | - |
|
|
|
|
|
| [[file:prompts/9.org][9]] | ~%~ | - |
|
2020-07-16 08:30:02 -06:00
|
|
|
|
|
|
|
|
** Example usage
|
|
|
|
|
|
|
|
|
|
#+begin_src shell
|
2021-03-10 16:59:52 -07:00
|
|
|
OHMYKSH_DIR=${HOME}/src/ohmyksh
|
2020-08-24 08:02:24 -06:00
|
|
|
. ${OHMYKSH_DIR}/ohmy.ksh
|
2020-07-16 08:30:02 -06:00
|
|
|
|
|
|
|
|
set -A my_paths -- \
|
|
|
|
|
/usr/ports/infrastructure/bin \
|
|
|
|
|
~/bin \
|
|
|
|
|
~/go/bin \
|
|
|
|
|
/usr/local/plan9/bin
|
|
|
|
|
|
|
|
|
|
paths "${my_paths[@]}"
|
|
|
|
|
|
|
|
|
|
load_extension fonts
|
|
|
|
|
load_extension k
|
|
|
|
|
load_extension nocolor
|
|
|
|
|
load_extension openbsd
|
|
|
|
|
|
|
|
|
|
load_completion ssh
|
|
|
|
|
load_completion vmd
|
|
|
|
|
load_completion rc
|
|
|
|
|
load_completion gopass
|
|
|
|
|
load_completion git
|
|
|
|
|
|
|
|
|
|
alias vi=vim
|
|
|
|
|
|
2020-07-19 07:37:05 -06:00
|
|
|
# the q prompt auto-loads the git-prompt extension
|
2020-07-16 08:30:02 -06:00
|
|
|
set_prompt q
|
|
|
|
|
#+end_src
|
2021-03-10 16:59:52 -07:00
|
|
|
|
