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 with hashtag support
• 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!

Bash (Linux)

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

After installing it using bash, it should work in any supported shell.

PowerShell (Windows)

powershell New-Item -Path $env:APPDATA\IntelliShell\Intelli-Shell\bin -Type Directory Invoke-WebRequest -UseBasicParsing -URI "https://github.com/lasantosr/intelli-shell/releases/latest/download/intelli-shell-x86_64-pc-windows-msvc.zip" -OutFile .\intelli-shell.zip Expand-Archive -Path intelli-shell.zip -DestinationPath $env:APPDATA\IntelliShell\Intelli-Shell\bin Remove-Item intelli-shell.zip $Path = [Environment]::GetEnvironmentVariable("PATH", "User") if ($Path -NotLike "*IntelliShell*") { $Path = $Path + [IO.Path]::PathSeparator + "$env:APPDATA\IntelliShell\Intelli-Shell\bin" }

After installing it using PowerShell, it should also work in cmd.

Source

To install from source you'll need to have Rust installed, which is recommended to be installed using rustup.

sh cargo install intelli-shell --locked

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

Windows users, as hotkeys are not enabled, will also need those:

• intelli-shell search to search for stored commands
• intelli-shell save "my command" to save a new command

Hotkeys

Hotkeys are only available on Linux:

• 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)
• [x] Support for more terminals
  • [x] [Fish](https://fishshell.com/)
  • [x] PowerShell
• [ ] 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.