xontrib-navi 0.0.3

Navi (interactive cli cheatsheet) integration

navi (interactive cli cheatsheet) integration into xonsh (shell)

If you like the idea click ⭐ on the repo

Install

xpip install xontrib-navi
# or: xpip install -U git+https://github.com/eugenesvk/xontrib-navi

Configure

• Add the following to your .py xontrib loading config and import it in your xonsh run control file (~/.xonshrc or ~/.config/rc.xsh):

from xonsh.xontribs 	import xontribs_load
from xonsh.built_ins	import XSH
envx = XSH.env

xontribs = [ "navi", # Initializes navi (interactive cli cheatsheet)
 # your other xontribs
] # ↓ optional configuration variables (use `False` to disable a keybind)
if 'navi' in xontribs: # Configure navi only if you're actually loading it
  # config var      	  value	 |default|alt_cmd¦ comment
  envx["X_NAVI_KEY"]	= "⎈g" 	#|c-g|   False¦ Autofill existing command with navi's best match or launch navi if no good match found

xontribs_load(xontribs) # actually load all xontribs in the list

• Or just add this to your xonsh run control file

xontrib load navi # Initializes navi (interactive cli cheatsheet)
# configure like in the example above, but replace envx['VAR'] with $VAR
$X_NAVI_KEY	= "c-g" # ...

Use

• Autoreplace the command without invoking any manual selection UI with navi's best match:
  git sta ⎈g git status
  • or hit it again to invoke the manual seletion UI:
    git status ⎈g navi UI
  • but failed best match will do nothing:
    git stu ⎈g git stu
• Split multiple commands and only autofill the one at the ‸cursor position:
  git sta‸; git show ⎈g git status‸; git show
ls -a‸ | rg 'txt' ⎈g ls -alt ‸| rg 'txt'

Known issues

• Bottom toolbar may temporary disappear on some invokations of the commands in this xonrib likely due to this xonsh issue

Credits

This package was created with xontrib template