AvaloniaUI.DeveloperTools.Windows 2.2.2

Prefix Reserved
dotnet tool install --global AvaloniaUI.DeveloperTools.Windows --version 2.2.2
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local AvaloniaUI.DeveloperTools.Windows --version 2.2.2
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=AvaloniaUI.DeveloperTools.Windows&version=2.2.2
                    
nuke :add-package AvaloniaUI.DeveloperTools.Windows --version 2.2.2
                    

Avalonia Developer Tools

The Avalonia Developer Tools is a standalone application that provides debugging and inspection capabilities for Avalonia applications. It connects to applications that have the Diagnostics Support package installed.

Prerequisites

Developer Tools requires .NET 6.0 or newer runtime to be installed on your system.

Installation

Install as .NET Global Tool

Install the Developer Tools globally using the .NET CLI:

  • For .NET 10+

    dotnet tool install --global AvaloniaUI.DeveloperTools
    
  • For .NET 6 to .NET 9

    You need to install platform-specific package:

    Windows:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Windows
    

    macOS:

    dotnet tool install --global AvaloniaUI.DeveloperTools.macOS
    

    Linux:

    dotnet tool install --global AvaloniaUI.DeveloperTools.Linux
    

After installation, you can launch it from terminal using:

avdt

Getting Started

For a complete setup guide including how to configure your application with the Diagnostics Support package, see the Developer Tools Getting Started Guide.

Usage

  1. Configure your Avalonia application with the AvaloniaUI.DiagnosticsSupport package
  2. Launch the Developer Tools application
  3. Run your configured Avalonia application
  4. In your application, press F12 to establish connection
  5. Activate the tool with your AvaloniaUI Portal credentials (first time only)

Troubleshooting

If you encounter connection issues or other problems, check the Developer Tools FAQ for common solutions and troubleshooting steps.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.2.2 189 6/2/2026
2.2.1 1,886 4/14/2026
2.2.0 455 4/7/2026
2.2.0-beta3 266 3/7/2026
2.2.0-beta2 310 1/23/2026
2.2.0-beta1 124 1/19/2026
2.1.1 3,101 11/13/2025
2.1.0 1,199 10/13/2025
2.0.4 660 6/18/2025
2.0.3 734 4/15/2025
2.0.2 489 4/9/2025
2.0.1 339 4/8/2025

# 2.2.2

> Note: Remember to update both the .NET tool and the `AvaloniaUI.DiagnosticsSupport` package in your project.

## Enhancements

* Added a new `DeveloperToolsRunner.Dnx` runner option that automatically downloads and installs the Dev Tools version matching the current DiagnosticsSupport package, via the .NET 10 `dotnet dnx` feature. This runner may become the default in the future.
* Object/DataContext preview in the property grid is now editable.
* DiagnosticsSupport now emits a compile-time error if the legacy `Avalonia.Diagnostics` package is also referenced, and a warning if an unsupported Avalonia major version is detected.
* DevTools now shows a warning when connecting to an app using an incompatible version of Avalonia or DiagnosticsSupport.
* Added support for the `AVALONIA_TOOLS_LICENSE_KEY` environment variable for offline authentication, as an alternative to an interactive sign-in. Enterprise licenses only.

## Fixes

* Fixed a potential race condition where windows opened between reading the tree and subscribing to changes could be missed by DevTools.
* Fixed the elements tree sometimes showing a broken or incomplete path when inspecting a node — paths now resolve correctly through templates, items controls, popups, and overlay layers.
* Fixed encoding of `Thickness`-like types with `NaN` values, which caused DevTools to fail to parse them.
* Fixed the application window position being saved/restored with invalid values.
* Fixed the connected application sometimes hanging on exit when closed while DevTools remained connected.
* Fixed an error dialog appearing in the connected application when the DevTools connection closed normally.
* Fixed several minor issues with the "Invalidate Inspector" button.
* Improved reliability of connection teardown between the application and DevTools.
* The "Freeze Popups" hotkey now also works for already-opened popups.
* MCP: Fixed nullable values in the `set_prop` tool not being handled correctly.

# 2.2.1

## Enhancements

* MCP: Added enum parameter validation, informing Agent about possible values.
* MCP: Improved error handling across multiple tools with more descriptive error messages.
* MCP: Tools now report if DevTools and DiagnosticsSupport versions are mismatched, helping to identify compatibility issues.

## Fixes

* Fixed 11.x compatibility issues with some target frameworks.
* Fixed browser compatibility with `AvaloniaUI.DiagnosticsSupport`.
* Fixed font viewer not opening fonts from Avalonia 12.
* Fixed Grid/Canvas attached properties not being visible when an element is inside a ListBox or another ItemsControl.
* Fixed binding values not being evaluated in the styles grid.
* Fixed inconsistent formatting of floating-point values in the property grid.
* MCP: Indie/Plus subscription is now properly accepted for MCP server authentication.
* MCP: Fixed `input(node, click)` tool not actually sending click events to the node.
* MCP: Improved `set-prop`, `props`, `input` tools input parameters validation.

# 2.2.0

## Enhancements

* Compatibility with Avalonia 12.0.
* DevTools MCP server is now available.
* DevTools can now discover and connect to running local desktop Avalonia applications directly from the Welcome screen, without needing to press F12 from the app.
* Added Visual/Logical/Merged tree toggle, replacing the old "Aggregate Templates" option (now Merged mode).
* Improvements to macOS native menu, new About dialog, and various UI refinements.
* The `AvaloniaUI.DiagnosticsSupport` package now displays a dialog when DevTools is not installed.
* Added new error dialogs for DevTools connection and protocol failures.
* Added support for the `DOTNET_CLI_HOME` environment variable for non-standard DevTools installation locations.
* Added a new `DeveloperToolsRunner.DotNetLocalTool` runner option, distinct from `DeveloperToolsRunner.DotNetTool`, which uses the global tool installation.
* The connected application is now focused when Inspect mode is activated.
* DevTools MCP and UI now support the `AVALONIA_TOOLS_LOG_LEVEL` environment variable for controlling logging verbosity. Set it to `debug` for detailed logs.

## Fixes

* Fixed several connectivity issues between the application and DevTools.
* Fixed an issue where elements tree search would stop if an element was detached from the tree during the search.

# 2.1.1

## Enhancements

* Added a filter option to restore the old DevTools behavior by showing all property setters instead of only the selected one.
* Added "Listen on any IP" setting, allowing connections outside of localhost.
* Elements tree nodes are now centered on selection.
* Removed spacing between elements tree nodes.

## Fixes

* Fixed issue with the "Show Rulers" setting being ignored.
* Fixed potential race condition with property grid editors.
* Fixed application not running on Windows on ARM.
* Fixed error that sometimes occurred when opening the routed events flyout.

# 2.1.0

## Enhancements

* Layout Visualizer has returned.
* The Sign In experience is now shared between Parcel and the VS extension, with updated dialog visuals.
* .NET 10-compatible NuGet package — the tool can now be installed as `AvaloniaUI.DeveloperTools` without a platform suffix.
* The Profiler tool is no longer experimental and is now always enabled.
* Improved title bar integration on Windows.
* On Windows and macOS, the tool creates a shortcut in the Start Menu / Applications folder. This can be disabled with the `AVALONIA_TOOLRUNNER_DISABLE_SHORTCUT` environment variable.

## Fixes

* Fixed flashing console window when opening on Windows.
* Fixed bug popups that appeared before DevTools connected.
* Fixed file logger sometimes creating a file in the drive root directory.
* Fixed "Update is available" notification showing when the tool is up to date.

# 2.0.4

## Enhancements

* New "Freeze Popups" context menu on the Window element node and a hotkey, allowing you to keep all popups open until unchecked.
* DevTools window is now the active window when an element is inspected from the connected app.
* The Apple build is now a universal (fat) package including arm64 and x64 (previously Rosetta was required).

## Fixes

* Variable property grid row columns across different pages, making settings and resources more accessible.
* Fixed DevTools not being able to connect to Android/iOS apps.
* Fixed popups not being properly displayed in the elements tree.
* Fixed `OverlayLayer` being ignored in the elements tree.
* `MetricsSupport` is now enabled by default in the user project in Debug configuration.

# 2.0.3

## Enhancements

* Automatic scroll for Logs and Events data grid pages. (#22)
* Previewer no longer opens DevTools when `ConnectOnStartup` is enabled. Instead, an `AutoConnectFromDesignMode` option was added for the previewer scenario. (#20)
* When the application cannot reach DevTools via F12 or `ConnectOnStartup`, it throws an exception on the dispatcher thread instead of silently ignoring it. This exception can be suppressed via `Dispatcher.UIThread.UnhandledException` if necessary.
* The Inspect mode hotkey/button now automatically enables highlighting with tooltips on the connected app when hovering.

# 2.0.2

## Enhancements

* New application icon.
* By default, the application now uses the system theme instead of forcing the dark variant.
* Experimental Compact mode was added.