IntelliShell

Like IntelliSense, but for shells!

IntelliShell acts like a bookmark store for commands, so you don't have to keep your history clean in order to be able to find something useful with ctrl + R.

It currently works on Bash, Zsh and Fish and should be compatible with most Linux, Windows and MacOS.

TL;DR

1. Install the binaries:

   sh curl -sSf https://raw.githubusercontent.com/lasantosr/intelli-shell/main/install.sh | bash

2. Bookmark your first command by typing it on a terminal and using ctrl + b

3. (optional) Run intelli-shell fetch to download commands from tldr

4. Hit ctrl + space to begin the journey!

Features

• Standalone binaries
• Autocomplete currently typed command
  • Full Text Search in both command and description
• Find & replace labels of currently typed command
• Non-intrusive (inline) and full-screen interfaces
• Fetch command to parse and store tldr pages (Thanks to them!)
• Portability. You can use bookmarked commands in any supported shell, as well as exporting and importing elsewhere.

Installation

Remember to bookmark some commands or fetch them after the installation!

Prebuilt

To install using prebuilt binaries:

sh curl -sSf https://raw.githubusercontent.com/lasantosr/intelli-shell/main/install.sh | bash

From source code

If your platform is not supported, you can also install using cargo, which is recommended to be installed using rustup.

sh cargo install intelli-shell --locked

You'll need to download the source script also:

sh mkdir -p ~/.local/share/intelli-shell curl -sSf https://raw.githubusercontent.com/lasantosr/intelli-shell/main/intelli-shell.sh > ~/.local/share/intelli-shell/intelli-shell.sh

Or, if using fish:

sh mkdir -p ~/.local/share/intelli-shell curl -sSf https://raw.githubusercontent.com/lasantosr/intelli-shell/main/intelli-shell.fish > ~/.local/share/intelli-shell/intelli-shell.fish

After that, you should edit your ~/.bashrc, ~/.zshrc or ~/.bash_profile to source it:

sh source ~/.local/share/intelli-shell/intelli-shell.sh

Or, if using fish you should edit ~/.config/fish/config.fish:

sh source ~/.local/share/intelli-shell/intelli-shell.fish

Usage

You can view supported actions by running intelli-shell -h. Most used standalone commands are:

• intelli-shell fetch [category] to fetch tldr commands and store them. [category] can be skipped or a valid folder from tldr's pages
• intelli-shell export to export user-bookmarked commands (won't export tldr's commands)
• intelli-shell import user_commands.txt to import commands into the user category

Hotkeys

• ctrl + b bookmark currently typed command
• ctrl + space show suggestions for current line
• ctrl + l replace labels of currently typed command
• esc clean current line, this binding can be skipped if INTELLI_SKIP_ESC_BIND=1

Note: When navigating items, selected suggestion can be deleted with ctrl + d

You can customize key bindings using environment variables: INTELLI_SAVE_HOTKEY, INTELLI_SEARCH_HOTKEY and INTELLI_LABEL_HOTKEY

Wishlist

• [x] Labels support to store most used labels and select them using a dedicated UI
• [ ] Usability improvements to manage stored commands (including aliases)
• [ ] Support for more terminals
  • [x] [Fish](https://fishshell.com/)
• [ ] Export also labels and UI to filter what to export
• [ ] Deploy to package managers
• [ ] Sync user bookmarks using some public / private Git repo

Alternatives

You might want to have a look at Marker which is pretty similar but requires Python to be installed on your system.

License

IntelliShell is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.