How to Add a New Debugger for Eclipse Che

Anatolii Bazko
Apr 2, 2019 · 3 min read

The simplest way to start developing a new debugger is to generate a sample and understand how it works. Integrating a new debugger into Eclipse Che is very similar to how it is done in VS Code. So, let’s install the latest Theia plugin yeoman generator which will generate a simple debugger plugin for Che Theia.

npm install -g yo @theia/generator-plugin

Generate a sample by running:

yo @theia/plugin

When prompted confirm choices for “Backend plug-in”, “Samples” and then “Debugger sample”:

It will create a project and a ready-to-use plugin which can be deployed in Che Theia. This is a mock debugger with a single configuration which allows debugging arbitrary text files. The purpose of this sample is to understand how things work. Let’s deploy and try it.

Build the plugin by running yarn in the root of the project and copy the resulted file ending with .theia into plugins folder of Che Theia. After that, start Theia. In theDebug menu, select Open Configurations. and in the launch.json file, add debug configuration for Theia Mock Debug:

Open any text file in the editor, switch to Debug View, and start the debugger using Debug a text file configuration. Now it is possible to debug a text file line by line:

Let’s briefly go through the generated project structure. package.json contains a section with a debugger contribution to Che Theia. This is a place to add a new debugger. More details and explanation about available attributes read here contributes.debuggers and here anatomy of package.json:

"contributes": {
"debuggers": [
"type": "theia-mock-debug",
"label": "Theia Mock Debug",

backend.ts file is plugin’s entrypoint. Implementation of plugin start and stop methods are here. theia-mock-debug-configuration-provider.ts is a basic implementation of a configuration provider. See details configuration provider.


Those files above represent debug adapter protocol implementation, copied from VS Code mock debug repository.

That’s basically it. To deeply understand Visual Studio Code’s debugging architecture read VS Code debugger extension documentation.

Get Involved!

Quick Start with Eclipse Che.

Join the community:

  • Support: You can ask questions, report bugs, and request features using GitHub issues.
  • Public Chat: Join the public eclipse-che Mattermost channel to discuss with community and contributors.
  • Weekly Meetings: Join us in our Che community meeting every second monday.
  • Mailing list:

Eclipse Che Blog

News and articles for Eclipse Che - next-generation Eclipse…

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store