OS Commands Tool

Index of All Documentation » Wing Pro Reference Manual »

Wing Pro and Wing Personal include an OS Commands tool that can be used to execute and interact with external commands provided by the OS or by other software, and to execute files outside of the debugger.

This is used for the Execute items in the Debug menu and Project context menu and to run any build command configured in Project Properties or Launch Configurations. It can also be used for other purposes such as integrating external commands into Wing, starting code that is debugged using wingdbstub, and so forth.

Adding and Editing Commands

Whenever a file is executed outside of the debugger, or when a build command is configured, these are added automatically to the OS Commands tool.

Additional items can be added with the Options menu's New commands, and any existing items can be edited or removed with the Edit and Remove items here. For details, see OS Command Properties.

Executing Commands

The Options menu also includes items for starting, terminating, or restarting a command, clearing the execution console, and selecting whether consoles should auto-clear each time the process is started or restarted.

For Python files, it is also possible to specify that the Python interpreter should be left active and at a prompt after the file is executed. This is done with the Python Prompt after Execution item in the Options menu.

The area below the popup menu at the top of the OS Commands tool is the console where commands are executed, where output is shown and where input can be entered for sending to the sub-process. Use the popup menu to switch between multiple running processes, or add multiple instances of the OS Commands tool to view them concurrently. The console provides a context menu (right click) for controlling the process, copy/pasting, and clearing or saving a copy of the output to a file.


The OS Commands Toolbox is hidden by default but can be shown with the Show Toolbox item in the Options menu. This contains the same items in the popup menu at the top of the OS Commands tool, but can be convenient for editing or removing multiple items, or quickly executing a series of commands. Right click on the list for available actions, or middle click or double click on the list to execute items.

Starting a Terminal

On Linux and OS X or when working with a project that points to a remote host, the OS Commands tool's Options menu includes an item Start Terminal that will start a new bash terminal.

To set up a terminal that runs a different shell, add a Command Line style OS Command with executable set to your shell executable (for example, for the Start Terminal menu item Wing sets this to``bash -norc``) and then enable the Use pseudo-TTY and Line mode options.

Note that Wing's OS Commands tool does not fully emulate a TTY, so the tab key, color, and cursor movement are not supported.

Section Contents