Novolis.Avalonia.Agent 2026.1.6.263

dotnet add package Novolis.Avalonia.Agent --version 2026.1.6.263
                    
NuGet\Install-Package Novolis.Avalonia.Agent -Version 2026.1.6.263
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Novolis.Avalonia.Agent" Version="2026.1.6.263" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Novolis.Avalonia.Agent" Version="2026.1.6.263" />
                    
Directory.Packages.props
<PackageReference Include="Novolis.Avalonia.Agent" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Novolis.Avalonia.Agent --version 2026.1.6.263
                    
#r "nuget: Novolis.Avalonia.Agent, 2026.1.6.263"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Novolis.Avalonia.Agent@2026.1.6.263
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Novolis.Avalonia.Agent&version=2026.1.6.263
                    
Install as a Cake Addin
#tool nuget:?package=Novolis.Avalonia.Agent&version=2026.1.6.263
                    
Install as a Cake Tool

Novolis

Novolis · Docs · Source

Novolis.Avalonia.Agent

Embeds a LocalIpc ui.* agent host in an Avalonia window so MCP / tooling can dump the visual tree, screenshot, click, type, select list/tab items, focus, and scroll.

Install

dotnet add package Novolis.Avalonia.Agent

Quick start

using Novolis.Avalonia.Agent;

// After MainWindow is created:
AgentHost.TryAttachFromEnvironment(desktop.MainWindow);

// Or always:
AgentHost.Attach(desktop.MainWindow);

// Dedicated pipe (when multiple Avalonia apps may run):
AgentHost.Attach(desktop.MainWindow, "novolis-avalonia-agent-myapp");

// Tag controls for stable ids:
AgentProperties.SetId(button, "lab.recovery");
AgentProperties.SetRole(button, AgentRoleNames.Button);

Methods

Method Purpose
ui.hello Handshake
ui.get Compact multi-id read (text/enabled/visible)
ui.items ListBox / ComboBox / TabControl item dump
ui.tree Interactive control dump (agent lists emit item rows)
ui.screenshot Window/control PNG
ui.click Click by id or coordinates (button: left/right/middle; clickCount for double-click)
ui.type Type/replace text + special keys (Clear replaces TextBox contents)
ui.select Select ListBox / ComboBox / TabControl by index or item text
ui.focus Focus a control by id
ui.scroll Scroll nearest ScrollViewer by delta, or bringIntoView
ui.wait Host-side wait (blocks UI thread — prefer MCP ui_poll while simulating)

Protocol version: 1.2. Unknown methods return a typed fault (clients do not hang).

Crash guard

CrashGuard.Install("MyApp");
// After Avalonia setup:
CrashGuard.InstallAvalonia(Dispatcher.UIThread);

Unhandled UI / task faults write %LocalAppData%/Novolis/<app>/crashes/crash-*.log (+ .dmp on fatal Windows process faults), open Notepad once, and mark dispatcher exceptions handled so the window stays up. Agent IPC faults are logged silently (ReportSilent) without killing the host.

Enable with env NOVOLIS_AVALONIA_AGENT=1. Optional endpoint override: NOVOLIS_AVALONIA_AGENT_ENDPOINT.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2026.1.6.263 74 11/10/2026
2026.1.6.262 66 11/10/2026
2026.1.6.260 76 11/10/2026
2026.1.6.259 97 11/9/2026
2026.1.6.253 82 11/9/2026
2026.1.6.252 88 11/8/2026
2026.1.6.250 109 10/25/2026
2026.1.6.249 105 10/21/2026
2026.1.6.248 99 10/19/2026
2026.1.6.247 102 10/18/2026
2026.1.6.244 103 10/18/2026
2026.1.6.243 95 10/18/2026
2026.1.6.242 89 10/18/2026
2026.1.6.241 94 10/18/2026
2026.1.6.240 93 10/12/2026
2026.1.6.230 101 10/6/2026
2026.1.6.229 103 10/4/2026
2026.1.6.228 101 10/4/2026
2026.1.6.226 97 10/4/2026
2026.1.6.221 99 10/4/2026
Loading failed