AvaloniaUI.DeveloperTools.macOS
2.2.1
Prefix Reserved
See the version list below for details.
dotnet tool install --global AvaloniaUI.DeveloperTools.macOS --version 2.2.1
dotnet new tool-manifest
dotnet tool install --local AvaloniaUI.DeveloperTools.macOS --version 2.2.1
#tool dotnet:?package=AvaloniaUI.DeveloperTools.macOS&version=2.2.1
nuke :add-package AvaloniaUI.DeveloperTools.macOS --version 2.2.1
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.DeveloperToolsFor .NET 6 to .NET 9
You need to install platform-specific package:
Windows:
dotnet tool install --global AvaloniaUI.DeveloperTools.WindowsmacOS:
dotnet tool install --global AvaloniaUI.DeveloperTools.macOSLinux:
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
- Configure your Avalonia application with the AvaloniaUI.DiagnosticsSupport package
- Launch the Developer Tools application
- Run your configured Avalonia application
- In your application, press F12 to establish connection
- 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.
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.2.2 | 89 | 6/2/2026 |
| 2.2.1 | 385 | 4/14/2026 |
| 2.2.0 | 152 | 4/7/2026 |
| 2.2.0-beta3 | 159 | 3/7/2026 |
| 2.2.0-beta2 | 152 | 1/23/2026 |
| 2.2.0-beta1 | 121 | 1/19/2026 |
| 2.1.1 | 659 | 11/13/2025 |
| 2.1.0 | 304 | 10/13/2025 |
| 2.0.4 | 292 | 6/18/2025 |
| 2.0.3 | 448 | 4/15/2025 |
| 2.0.2 | 406 | 4/9/2025 |
| 2.0.1 | 333 | 4/8/2025 |
# 2.2.1
Don't forget to update both the .NET tool and the `AvaloniaUI.DiagnosticsSupport` package in your project.
## 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.