Run scripts and shells within a proper terminal.

apm install script-runner@2.6.0


Script Runner

This package will run various script files inside of Atom, and uses a proper terminal for output. It currently supports JavaScript, CoffeeScript, Ruby, Python, Bash, Go and anything with a shebang line.



N.B. these keyboard shortcuts are currently being reviewed, input is welcome.

Command Mac OS X Linux
Script Runner: Run ctrl-x alt-x
Script Runner: Shell

Scripts which have been saved run in their directory, unsaved scripts run in the workspace root directory. Selecting a single line will only run that one line.

A right-click context menu can be used to send signals to the running process, and as you may expect, you can interact directly with the terminal, typing input, pressing ctrl-c, and so on.

Closing a terminal will cause its process to be killed.

Run Selection

When invoking the above Run: Script command, if a portion of the script is selected, only that portion will be executed.

User Input

When running a script, the focus will be passed to the script output terminal. You are welcome to use the keyboard and mouse to interact with the running program.

Shebang Lines

In a typical UNIX environment, the shebang line specifies the interpreter to use for the script:

#!/usr/bin/env ruby
puts "Hello World"

The shebang line is the preferred way to specify how to run something as it naturally supports all the intricacies of your underlying setup, e.g. Ruby's rvm, Python's virtualenv.

Even for unsaved files without an associated grammar, as long as you have the correct shebang line it will be executed correctly.

Environment Variables

The default Atom process takes environment variables from the shell it was launched from. This might be an issue if launching Atom directly from the desktop environment when using, say, RVM which exports functionality for interactive terminal sessions.

To ensure consistent behavior, when running a script, environment variables are extracted from the interactive login shell. This usually loads the same environment variables you'd expect when using the terminal.


Split Direction

It is possible to configure which way to split the new pane. Open your Atom config file and edit 'script-runner'.splitDirection, the possible values are: 'bottom', 'left' and 'right'. For example:

		'splitDirection': 'bottom'

Scrollback Distance

To limit the number of lines kept in the output window simply edit the 'script-runner'.scrollback option in your Atom config file.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Released under the MIT license. Please see for the full license.