ShellWax is a shell script development plugin for the Eclipse IDE, providing a rich edition experience through integration with the Bash Language Server.

With Eclipse IDE properly installed on your machine, just click HERE

OR

Browse to https://marketplace.eclipse.org/content/shellwax and follow installation instructions

OR

From a working Eclipse IDE, install from the Update Site:

• Releases: https://download.eclipse.org/shellwax/releases/latest/
• Snapshots (built from master): https://download.eclipse.org/shellwax/snapshots/

• Eclipse IDE running on Java 25 or newer.
• Bash (bash) available on the PATH, needed to run scripts. Note: Windows users should have bash installed via Windows Subsystem For Linux and their distro of choice.
• Optional: shfmt on the PATH to enable the Format command.

Node.js and the Bash Language Server itself are provided automatically: Node.js is embedded via the Wild Web Developer node embedder and the language server is installed on first use.

ShellWax brings together multiple different sources of features to make an enjoyable developing environment. Here are just a few of the most common features. Download today to discover all ShellWax has to offer.

The syntax highlighting is "externalized" to TM4E plugins. You can configure a theme (in the TextMate meaning of a theme) for specific file type in Preferences > TextMate > Grammar, select a language and then click the "Theme" tab on that same page.

The Bash Language Server supplies ShellWax with the majority of the edition abilities. More information can be found at the Bash Language Server GitHub Repository.

• Jump to declaration
• Find references
• Code Outline & Show Symbols
• Highlight occurrences
• Code completion
• Simple diagnostics reporting
• Documentation for flags on hover
• Formatting (when shfmt is installed)

Files without an extension whose first line is a #!/bin/sh or #!...bash shebang are recognized as shell scripts: they open in the shell script editor and get the shell script icon.

Right click a shell script and choose Run As > Shell Script to run it in the Console view. The launch configuration allows setting arguments, the working directory and enabling -x to trace executed commands.

ShellWax is an Open Source project licensed under The Eclipse Public License - v 2.0

More Licensing Information

See CONTRIBUTING.md. Issues are tracked in GitHub issues.