Repository navigation
Releases
Releases · microsoft/winappCli
Release v0.8.0
Version: 0.8.0
Commit: e5cedcc04921f6f74535cf45668292203e439d45
What's Changed
Other Changes
- Fix two flaky execution-target tests by Alexandre Zollinger Chohfi (@azchohfi) in #950
- Fix
winapp new -t reactorwhen another template pack also registersreactorby Alexandre Zollinger Chohfi (@azchohfi) in #949 - Hold and verify every WinUI triage debugger DLL until triage finishes by Alexandre Zollinger Chohfi (@azchohfi) in #954
- Stop certificate tests leaking dev certificates into CurrentUser\My by Alexandre Zollinger Chohfi (@azchohfi) in #953
- Use absolute URLs for winapp-sandbox doc links by Nikola Metulev (@nmetulev) in #960
- Fix release-build timeout in GuestProcessHost output-drain test by Nikola Metulev (@nmetulev) in #962
- Update AI agent detection to the env vars agents set today by Nikola Metulev (@nmetulev) in #963
- Bump version to 0.7.2 for development by Nikola Metulev (@nmetulev) in #944
- Skip a Windows App SDK release until its pinned sub-packages are published by Alexandre Zollinger Chohfi (@azchohfi) in #956
- Capture windowed popups when recording or screenshotting an element by Nikola Metulev (@nmetulev) in #967
- Keep winapp usable when %USERPROFILE%.winapp is not writable by Nikola Metulev (@nmetulev) in #941
- Bump Electron Forge to 8 and @electron/fuses to 2 in Electron samples by Nikola Metulev (@nmetulev) in #961
- Emit JSON when
cert generate --if-exists skip --jsonkeeps an existing file by Zach Teutsch (@zateutsch) in #970 - Fix
winapp run <dir>ambiguity error listing non-runnable projects by Zach Teutsch (@zateutsch) in #971 - Add CI checks for agent skill packages by Nikola Metulev (@nmetulev) in #972
- Fix intermittent Cli-2 test failures and bound the winui-unpackaged sample wait by Nikola Metulev (@nmetulev) in #980
- List WinUI templates first in
winapp newby Alexandre Zollinger Chohfi (@azchohfi) in #989 - Fix
ui get-propertyreporting ordinary text boxes as password fields by Nikola Metulev (@nmetulev) in #965 - winapp run: suggest --debug-output when an attached app exits nonzero by Zach Teutsch (@zateutsch) in #991
- send-keys: hold capslock/insert for screen-reader commands; reject unknown modifiers by Zach Teutsch (@zateutsch) in #990
- Fix flaky real MP4 encoder tests (MF_E_SINK_NO_SAMPLES_PROCESSED) by Nikola Metulev (@nmetulev) in #966
- Stop leaking a private-key container on every PFX sign by Zach Teutsch (@zateutsch) in #992
- Reorder root help around the app development workflow by Niels Laute (@niels9001) in #987
- Add local agent plugin benchmark (v1) by Nikola Metulev (@nmetulev) in #973
- Import WinUI agent plugin from win-dev-skills (unchanged) by Nikola Metulev (@nmetulev) in #976
- Add WinUI to the Claude/OpenClaw catalog and move WinUI skill script tests by Nikola Metulev (@nmetulev) in #1007
- Stop tracking generated command wrappers and schema snapshots by Nikola Metulev (@nmetulev) in #997
- Make the AtomicFile reader-holds-destination test deterministic by Nikola Metulev (@nmetulev) in #998
- Fix windowed-popup screenshot test flake: wait for the popup to be composited by Nikola Metulev (@nmetulev) in #1003
- Benchmark v1.1: agent selection, credit cap, 42 scenarios, comparisons by Nikola Metulev (@nmetulev) in #981
- Don't downgrade a newer template pack with --template-version latest by Zach Teutsch (@zateutsch) in #1017
- Add -V short alias for --version by Zach Teutsch (@zateutsch) in #1018
- Fix ui -a for hosted apps and show editable elements in inspect --interactive by Nikola Metulev (@nmetulev) in #993
- Fix Sandbox "Access is denied" failures and keep the Sandbox window on screen by Nikola Metulev (@nmetulev) in #964
- Support C++ (.vcxproj) projects in winapp run by Nikola Metulev (@nmetulev) in #984
- Add --type/--root/--class-name to every single-element ui command by Nikola Metulev (@nmetulev) in #932
- Agent-first
winapp uihelp and unknown-command suggestions by Nikola Metulev (@nmetulev) in #942 - Benchmark v2: capability-based realistic scenarios and held-out set by Nikola Metulev (@nmetulev) in #982
- Replace the winapp plugin agent with a short skill router by Nikola Metulev (@nmetulev) in #983
- Print help and CLI schema locally when --on is given by Zach Teutsch (@zateutsch) in #1034
- winapp run --on sandbox --json: don't also forward --quiet to the guest by Nikola Metulev (@nmetulev) in #1033
- winapp run: fix packaged C++ Debug apps failing on the debug CRT path by Nikola Metulev (@nmetulev) in #1030
- Skill descriptions ≤300 chars, WinUI scope rule, and 'give the command' line by Nikola Metulev (@nmetulev) in #985
- Remove the winui-session-report skill by Nikola Metulev (@nmetulev) in #1036
- Add worktree-isolated identity to winapp run by Nikola Metulev (@nmetulev) in #872
- Report the actual crash in --debug-output dumps, not an earlier handled exception by Zach Teutsch (@zateutsch) in #1019
- Explain why a
winapp uicommand is waiting by Zach Teutsch (@zateutsch) in #1026 - Make closing winapp's Sandbox window end the Sandbox, after Windows asks by Nikola Metulev (@nmetulev) in #1047
- Benchmark: demand scenario set, outcome judging, and reference-read tracking by Nikola Metulev (@nmetulev) in #1050
- Read Toolkit samples from the index the Toolkit publishes by Jaylyn Barbee (@Jaylyn-Barbee) in #988
- Handle minimized windows in
winapp uiby Nikola Metulev (@nmetulev) in #1054 - find-ui: search control descriptions and add an API list to the sample index by Jaylyn Barbee (@Jaylyn-Barbee) in #1048
- Stop winapp run hanging when several packaged launches deploy at once by Zach Teutsch (@zateutsch) in #1058
- Show host prerequisites in
target snapshot sandboxby Zach Teutsch (@zateutsch) in #1028 - Fix winapp new picking a stale template cache's --dotnetVersion option by Nikola Metulev (@nmetulev) in #1063
- Make winapp run output as clean as dotnet build by Nikola Metulev (@nmetulev) in #1037
- feat: add WinUI ETW performance recording and analysis by Morten Nielsen (@dotMorten) in #837
- Fix
winapp run --unregister-on-exitleaving the package registered when not elevated by Zach Teutsch (@zateutsch) in #1067 - Simpler PRs and issues, and reviews that don't grow simple changes by Nikola Metulev (@nmetulev) in #1074
- Read winapp new's template cache from DOTNET_CLI_HOME when it is set by Nikola Metulev (@nmetulev) in #1068
- Add .NET file-based app sample and guide by Zach Teutsch (@zateutsch) in #1066
- Pin System.Security.Cryptography.Pkcs to 10.0.13 for GHSA-846f-f764-76mx / GHSA-2fmv-rv2c-59x7 by Nikola Metulev (@nmetulev) in #1079
- Fix winapp run/package building a referenced library twice (APPX1101/PRI252) by Nikola Metulev (@nmetulev) in #1032
- Add --at x,y to ui click and ui hover by Nikola Metulev (@nmetulev) in #1103
- Prefer an element named exactly the selector text in single-element ui commands by Nikola Metulev (@nmetulev) in #1102
- Fix
winapp uihanging on WinUI 3 apps with a WebView2 by Nikola Metulev (@nmetulev) in #1101 - Let --type and --class-name be the whole
winapp uiquery by Nikola Metulev (@nmetulev) in #1104 - Add
--wheel-horizontaltowinapp ui scrollby Nikola Metulev (@nmetulev) in #1100 - Fix ui --json reporting invokableAncestor as disabled at 0,0 by Nikola Metulev (@nmetulev) in #1099
- Add --angle to ui touch pinch/stretch by Nikola Metulev (@nmetulev) in #1098
- winapp run: detect the Windows App SDK in C++ projects that import it through packages.config by Nikola Metulev (@nmetulev) in #1086
- Sign packages with the hash algorithm they were built with by Nikola Metulev (@nmetulev) in #1097
- Add the app benchmark (benchmarks/apps) by Nikola Metulev (@nmetulev) in #1108
- Honor -p:Configuration for C++ projects in winapp run by Nikola Metulev (@nmetulev) in #1085
- Add a task-completion benchmark for the agent plugins by Nikola Metulev (@nmetulev) in #1052
- WinUI DevTools: inspect, comment on an...
Release v0.7.1
Version: 0.7.1
Commit: e3cd0b94f3e7b776ac51ba0564f4908094e979b5
What's Changed
Other Changes
- Bump version to 0.7.1 for development by Zach Teutsch (@zateutsch) in #933
- Remove AI-generated PR descriptions by Nikola Metulev (@nmetulev) in #935
- Deliver project context telemetry at its approved collection rate by Nikola Metulev (@nmetulev) in #940
- Hide MSBuild property JSON from
winapp run --aotoutput by Nikola Metulev (@nmetulev) in #936
Full Changelog: v0.7.0...v0.7.1
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.7.0
Version: 0.7.0
Commit: 2fdd020c5b7db093e8b3e317b22bdd8135a47e89
What's Changed
Other Changes
- Update nuget network policy for release failure by Zach Teutsch (@zateutsch) in #740
- Remove the thread-pool dependency from the PID-file tests by Alexandre Zollinger Chohfi (@azchohfi) in #737
- Verify build tools are Microsoft-signed before running them by Alexandre Zollinger Chohfi (@azchohfi) in #738
- Bump version to 0.6.1 for development by Zach Teutsch (@zateutsch) in #736
- Add a consolidated security guidance page for developers by Alexandre Zollinger Chohfi (@azchohfi) in #735
- Invoke build tools directly in sample tests instead of Invoke-Expression by Alexandre Zollinger Chohfi (@azchohfi) in #726
- Document the internal NuGet feed needed to run tests on a corp machine by Alexandre Zollinger Chohfi (@azchohfi) in #746
- Use the preinstalled Rust toolchain instead of an unpinned third-party action by Alexandre Zollinger Chohfi (@azchohfi) in #747
- Say what the default certificate password actually means by Alexandre Zollinger Chohfi (@azchohfi) in #745
- Verify the gh download in both release stages, and bump it to 2.97.0 by Alexandre Zollinger Chohfi (@azchohfi) in #748
- Make dotnet run pass its arguments to the app, as it does without the package by Alexandre Zollinger Chohfi (@azchohfi) in #724
- Fix the two flaky tests taking down build-and-package by Alexandre Zollinger Chohfi (@azchohfi) in #751
- Add OneFuzz harness for ZipRangeExtractor and fix a bounds gap it found by Alexandre Zollinger Chohfi (@azchohfi) in #765
- Publish release symbols to symweb and MSDL by Alexandre Zollinger Chohfi (@azchohfi) in #766
- Publish NuGet from a separate pipeline so release.yml keeps CFSClean by Alexandre Zollinger Chohfi (@azchohfi) in #750
- Raise the build job timeout to 120 minutes by Alexandre Zollinger Chohfi (@azchohfi) in #775
- Bump version to 0.6.3 for development by Alexandre Zollinger Chohfi (@azchohfi) in #772
- Fix MS Learn docs generation: guides index rendering, broken security link, and ms.date churn by Jaylyn Barbee (@Jaylyn-Barbee) in #777
- Explain 0x80073CF9 instead of surfacing a bare HRESULT by Alexandre Zollinger Chohfi (@azchohfi) in #782
- Omit registry URLs from the npm lockfile by Jamie Magee (@JamieMagee) in #781
- Limit template update checks to once a day for winapp new by Zach Teutsch (@zateutsch) in #757
- Update winapp new to warn when scaffolding is taking longer than expected by Zach Teutsch (@zateutsch) in #756
- Adopt Agent Plugins 1.0 for the winapp plugin by Jaylyn Barbee (@Jaylyn-Barbee) in #784
- Make agent guidance audience-aware by Nikola Metulev (@nmetulev) in #786
- Resolve
$targetnametoken$ for WinAppSDK self-contained apps by Alexandre Zollinger Chohfi (@azchohfi) in #793 - Revert "Publish NuGet from a separate pipeline so release.yml keeps CFSClean" by Alexandre Zollinger Chohfi (@azchohfi) in #795
- Surface dotnet new post-action output under --verbose for new command by Zach Teutsch (@zateutsch) in #755
- Count JS bindings recursively in the electron sample test by Jaylyn Barbee (@Jaylyn-Barbee) in #800
- Test shared Windows app-model conformance vectors by Amaury Levé (@Evangelink) in #797
- Rehearse the release weekly from the release pipeline itself by Alexandre Zollinger Chohfi (@azchohfi) in #783
- feat: find-ui works offline — bake the corpus into the binary, refresh cache every 24h by Jaylyn Barbee (@Jaylyn-Barbee) in #770
- Ship the UI Automation engine as its own NuGet packages by Alexandre Zollinger Chohfi (@azchohfi) in #799
- Support the experimental Reactor templates in
winapp newby Alexandre Zollinger Chohfi (@azchohfi) in #814 - Add bounded project context telemetry by Nikola Metulev (@nmetulev) in #785
- Re-land the NuGet-client migration on stable NuGet 7.9.0 by Alexandre Zollinger Chohfi (@azchohfi) in #761
- feat: define the shared WinUI sample index contract (#703 Phase 0) by Jaylyn Barbee (@Jaylyn-Barbee) in #806
- Ship the WinUI 3 Roslyn analyzer as a standalone NuGet package by Zach Teutsch (@zateutsch) in #759
- Handle required architecture publish profiles in winapp run by Nikola Metulev (@nmetulev) in #788
- Cooperative UI turns for concurrent
winapp uiagents by Nikola Metulev (@nmetulev) in #767 - Fix design-time XAML compile items and defer to WinUI's own target by Alexandre Zollinger Chohfi (@azchohfi) in #826
- Run a .NET file-based app with package identity by Alexandre Zollinger Chohfi (@azchohfi) in #794
- Keep short recordings from ending before the first frame by Alexandre Zollinger Chohfi (@azchohfi) in #830
- Stream project restore progress during winapp run by Nikola Metulev (@nmetulev) in #789
- feat: add winapp find-api — local Windows/WinRT API metadata search (port of winmd) by Jaylyn Barbee (@Jaylyn-Barbee) in #744
- fix(find-ui): Gallery corpus is upstream-only; ten controls that returned no code now do by Jaylyn Barbee (@Jaylyn-Barbee) in #815
- Never serve sample code that still contains a substitution placeholder by Jaylyn Barbee (@Jaylyn-Barbee) in #852
- Stop reporting service connections as missing when the build identity cannot see them by Alexandre Zollinger Chohfi (@azchohfi) in #850
- Run and automate apps in persistent Windows execution targets by Nikola Metulev (@nmetulev) in #779
- Avoid re-resolving one-shot UI elements by Nikola Metulev (@nmetulev) in #841
- Auto-generated baselines by 1ES Pipeline Templates by @microsoft-github-policy-service[bot] in #858
- Fail the build when a shipped binary is unsigned by Alexandre Zollinger Chohfi (@azchohfi) in #861
- Exercise the federated release connections instead of inspecting them by Alexandre Zollinger Chohfi (@azchohfi) in #860
- Add typed UI geometry context by Nikola Metulev (@nmetulev) in #844
- Fix incomplete UI Automation descendant searches by Nikola Metulev (@nmetulev) in #842
- Stop filing issues for routine find-ui corpus drift by Jaylyn Barbee (@Jaylyn-Barbee) in #825
- Add scoped and typed UI Automation queries by Nikola Metulev (@nmetulev) in #848
- Expose whole-document TextPattern formatting in get-property by Nikola Metulev (@nmetulev) in #847
- Upgrade SkiaSharp and Svg.Skia past the libexpat CVE by Alexandre Zollinger Chohfi (@azchohfi) in #864
- Stop shipping IntelliSense XML the CLI cannot read by Alexandre Zollinger Chohfi (@azchohfi) in #867
- Baseline BinSkim BA2007 for libHarfBuzzSharp.dll by Alexandre Zollinger Chohfi (@azchohfi) in #868
- Update CsWin32 and analyzer dependencies while preserving compiler compatibility by Nikola Metulev (@nmetulev) in #869
- Add winapp run --aot by Nikola Metulev (@nmetulev) in #817
- Add deterministic explicit UI invoke actions by Nikola Metulev (@nmetulev) in #846
- Support packaged dotnet run for .NET file-based apps by Alexandre Zollinger Chohfi (@azchohfi) in #874
- Pack project-mode support by Zach Teutsch (@zateutsch) in #829
- Update banner to WinUI blue gradient by Niels Laute (@niels9001) in #894
- Publish PR artifacts early and reuse them across validation by Nikola Metulev (@nmetulev) in #870
- Add opt-in manual prerelease publish for library NuGet packages by Zach Teutsch (@zateutsch) in #851
- Add a contributor PR lifecycle skill by Nikola Metulev (@nmetulev) in #896
- Add local code-quality pre-check skill for csharp-code-quality rules by Zach Teutsch (@zateutsch) in #893
- Expose the working directory in target snapshots by Nikola Metulev (@nmetulev) in #882
- Make
cert installaccept a public .cer (issue #838) by Zach Teutsch (@zateutsch) in #891 - Fix cert generate --manifest silently falling back to user name (#839) by Zach Teutsch (@zateutsch) in #890
- Correct dotnet output-draining documentation by Nikola Metulev (@nmetulev) in #907
- Fix screenshot host-path reporting and composite help by Nikola Metulev (@nmetulev) in #884
- Fix empty UI values falling through to accessibility labels by Nikola Metulev (@nmetulev) in #878
- Reject malformed publisher DNs in cert generate (#845) by Zach Teutsch (@zateutsch) in #892
- docs: link security guidance from README by Zach Teutsch (@zateutsch) in https://github.com/microsoft/winap...
Release v0.6.1
Version: 0.6.1
Commit: d9a8d0f8ef192fa3ce07febdbe178606ea5fb4f5
Full Changelog: v0.6.0...v0.6.1
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.6.0
Version: 0.6.0
Commit: b7494ed3b324d6e378cb17b477f2b1a9729765d0
What's Changed
New Features
- Fix MSIX bundle version generation by Carlos Nihelton (@CarlosNihelton) in #678
- Add Node.js sample using a native WinUI 3 Application and Window by leileizhang (@lei9444) in #624
Other Changes
- Bump version to 0.5.1 for development by Zach Teutsch (@zateutsch) in #682
- Azure artifact signing with new az-sign command by Zach Teutsch (@zateutsch) in #595
- Backfill MS Learn doc fixes and add validation gate by Jaylyn Barbee (@Jaylyn-Barbee) in #685
- pr-review: rebuild the skill at a third the size, and stop it driving scope creep by Nikola Metulev (@nmetulev) in #696
- Add winapp-pr, a helper for installing CLI MSIX builds from PRs by Nikola Metulev (@nmetulev) in #697
- Fix winapp-pr web installer closing the caller's terminal by Nikola Metulev (@nmetulev) in #698
- Offer to set up the GitHub CLI in winapp-pr instead of just demanding it by Nikola Metulev (@nmetulev) in #700
- Offer a one-command build install in the PR metrics comment by Nikola Metulev (@nmetulev) in #699
- ci: make sample-test Pester install resilient to PSGallery flake by Nikola Metulev (@nmetulev) in #701
- Add winapp-pr -Update, -Help, and build freshness in the picker by Nikola Metulev (@nmetulev) in #702
- Add
.csproj"project mode" towinapp runby Nikola Metulev (@nmetulev) in #612 - fix(winapp-pr): paginate the artifacts query so a busy run's package is findable by Nikola Metulev (@nmetulev) in #705
- Add agent-readable UI recording artifacts by Nikola Metulev (@nmetulev) in #690
- Pin GitHub Actions to full-length commit SHAs by Microsoft Open Source Security Bot (@OssSecurityBot) in #707
- Add support for sparse packaging workflows by Zach Teutsch (@zateutsch) in #607
- Unify Copilot and Claude skills into a single shared plugin by Nikola Metulev (@nmetulev) in #631
- Add winapp-maui skill for the MAUI resizetizer manifest dependency by Pedro Jesus (@pictos) in #610
- Make winapp-pr usable immediately after -AddToPath by Nikola Metulev (@nmetulev) in #720
- Add winapp-pr -Uninstall and bound the download cache by Nikola Metulev (@nmetulev) in #721
- [s360-breeze-toolkit: SFI-ES-4.2.4] Use internal npm feed in Azure Pipelines by Alexandre Zollinger Chohfi (@azchohfi) in #715
- feat: add winapp find-ui — WinUI control & sample search (Gallery + Toolkit + Reactor) by Jaylyn Barbee (@Jaylyn-Barbee) in #681
winapp newcommand by Zach Teutsch (@zateutsch) in #686- Invoke the CLI directly instead of building command strings in package-msix.ps1 by Alexandre Zollinger Chohfi (@azchohfi) in #725
- Show folder-mode discovery breadcrumb only at debug verbosity by Alexandre Zollinger Chohfi (@azchohfi) in #730
- Cover NuGet and npm in Dependabot, and use the CodeQL security-extended suite by Alexandre Zollinger Chohfi (@azchohfi) in #728
- Use -EncodedCommand for the elevated Developer Mode script by Alexandre Zollinger Chohfi (@azchohfi) in #727
- Map the remaining winapp run options to MSBuild properties by Alexandre Zollinger Chohfi (@azchohfi) in #731
- Fix flaky tree-kill test by retrying the PID file read by Alexandre Zollinger Chohfi (@azchohfi) in #732
New Contributors
- Carlos Nihelton (@CarlosNihelton) made their first contribution in #678
- Microsoft Open Source Security Bot (@OssSecurityBot) made their first contribution in #707
- Pedro Jesus (@pictos) made their first contribution in #610
Full Changelog: v0.5.0...v0.6.0
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.5.0
Version: 0.5.0
Commit: fd7cb6f235fa54dd2c6e26386e65e967a2c8797a
New Features
- Add
ui recordcommand for MP4 capture (#599) — Users can now record app interactions and output them as MP4 files, enhancing the ability to create tutorials and demos directly from winapp CLI. - Add
ui touchandui pencommands (#600) — New commands allow for simulation of touch and pen inputs, making it easier to automate scenarios for touch-enabled applications. - Add
--allow-system-keystoui send-keys(#603) — This option enables the use of system keys in keyboard simulations, broadening the range of inputs that can be automated in applications.
Breaking Changes
- Standardize UI coordinate terminology (#660) — The term "app" has been replaced with "screen" in the coordinate definitions. Users should adjust their coordinate references in scripts and documentation to accommodate this change.
Bug Fixes
- Fix
ui send-keys --via send-inputsilently dropping characters (#657) — This fix ensures all characters are sent accurately, particularly for longer texts, improving automation reliability. - Fix
ui send-keys --via post-messagesilently dropping input (#666) — Input handling has been improved to prevent missed key events during automation, enhancing overall functionality. - Fix misleading code coverage measurement (#630) — Addresses prior issues with coverage reporting, providing more accurate information for test evaluations.
Documentation
- Add native PowerShell winget cmdlet to README.md (#594) — Updated documentation now includes guidance for using the native PowerShell
wingetcmdlet, helping users understand package management more effectively.
Infrastructure
- Bump the npm_and_yarn group across 1 directory with 2 updates (#675) — This update ensures that the tool benefits from the latest features and fixes available in the npm and Yarn ecosystems.
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.4.0
Version: 0.4.0
Commit: 6bcad3ae827f0ecf34773ad5e7dbfe9e1920a712
New Features
- Integrate JS/TS WinRT bindings (#536) — The
winapp initcommand now supports JavaScript and TypeScript WinRT bindings, enabling developers to manage their projects with these languages directly. - Add "ui hover" command (#583) — Introduced a new command
ui hoverto capture tooltips, flyouts, and other UI elements, enhancing debugging and interaction testing. - List visible windows option (#571) — The
list windowscommand now shows visible windows without titles by default and includes a new--show-hiddenflag for optional display of all windows.
Bug Fixes
- Fix cert bug with multi-component publisher validation (#573) — Resolved an issue that prevented proper validation of certificates when multiple components were involved, improving reliability in app submissions.
- Screenshot command directory creation (#576) — The
screenshotcommand now automatically creates non-existent output directories instead of throwing an error, simplifying the screenshot process. - Fix for PoliCheck non-inclusive language findings (#580) — Addressed non-inclusive language issues identified by PoliCheck, enhancing compliance with language standards.
Infrastructure
- Dependency updates — Bumped multiple dependencies for
undici(#584),form-data(#581),markdown-it(#582),js-yaml(#578), andesbuild(#577) to their latest versions, improving overall performance and security.
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.3.2
Version: 0.3.2
Commit: 1c6e75e90f3d0eff890021335261254fa01dd8c7
New Features
- MSIX Bundle Support for
packCommand (#546) — Thepackcommand now supports creating MSIX bundles, streamlining the packaging process for Windows apps. - App Update Notification (#503) — A daily check now notifies users of any available updates for the CLI on their first command run each day, ensuring developers stay informed about new versions.
- Enhanced
winapp initBehavior (#530) — Improved project detection and file placement during initialization, along with warnings for incompatible directories, enhances the usability of theinitcommand. - Higher quality screenshots for
winapp ui screenshot(#522) — Updatedui screenshotcommand to produce higher quality screenshots, and added support for--focusflag.
Breaking Changes
- Publishing VSCE Integrated into CI (#499) — The pipeline now includes an automated process for publishing VS Code extensions. Users need to manage the new
SkipVscReleaseparameter in the pipeline configuration, which defaults totrueuntil they are ready for publishing:parameters: - name: SkipVscRelease displayName: Skip VSC Release type: boolean default: true
Bug Fixes
winapp initCrash Fixed (#559) — Resolved an issue that causedwinapp initto crash in non-interactive shells, now default behaviors apply as expected.- Removed Duplicates in MSIX Packing (#554) — Fixed a bug where files from the runtime would overwrite existing resources in the final MSIX package.
- Improved Process Name Ambiguity Reporting (#564) — Fixed issues with reporting ambiguity on partial process name matches, improving command execution reliability.
- Update Check Timeout Resolved (#558) — Addressed a timeout bug in the update check, allowing for seamless notifications of available updates.
Documentation
- Automating MS Learn Documentation Updates (#518) — Introduced a new pipeline step to automatically update documentation on Microsoft Learn, ensuring consistency across resources.
- Enhancements to VS Code Extension Release Documentation (#519) — Improved formatting and clarity in the VS Code extension release process documentation.
Infrastructure
- Dependency Updates — Updated various dependencies, including
qs(#561),@tootallnate/once(#560, #547),brace-expansion(#539),tmp(#553), andfast-uri(#527, #528).
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.3.1
Version: 0.3.1
Commit: c8ada4a403c43b96780b87abc454cba51f649c60
Breaking Changes
winapp ui --jsonenvelope reshape (#511) — JSON output shapes are not backward compatible. Update any scripts/tools parsing these outputs:ui inspect --json— elements are now nested under{ depth, interactive, hideDisabled, hideOffscreen, windows: [{ hwnd, title, className, elementCount, elements: [{ ..., children: [...] }] }] }(was a flat{ elements: [...] }list). Per-elementid,depth,parentSelector, andwindowHandlefields have been removed —selectoris the public handle.ui inspect --ancestors --json— ancestors are now nested via aDepth=iparent → child chain (previously emitted as sibling roots).ui get-focused --json— emits a{ hasFocus: false }or{ hasFocus: true, element: {...} }envelope (was a barenullwhen nothing was focused).ui search --json/ui wait-for --json— internalid,parentSelector, andwindowHandlefields are scrubbed from results (top-level and nestedinvokableAncestor).
New Features
winapp runsupport for--passthrough arguments (#506) — Pass application arguments directly using--without escaping them in quotes. For example, instead of:you can now write:winapp run . --args "--my-flag value"
winapp run . -- --my-flag value- Plain progress streaming in CI and AI-agent terminals (#507) — Auto-detects environments that can't honour cursor control (GitHub Actions, Azure DevOps, Copilot CLI, Claude Code, etc.) and falls back to append-only line-buffered progress output. Real interactive terminals continue to render the animated spinner tree;
--quiet/--jsonremain silent. No new flags or env vars. ui inspect --interactiveancestor surfacing (#511) — Non-interactive ancestors are collapsed and surfaced asancestorPathon surviving descendants;+moremarkers indicate truncated subtrees in both text and JSON modes.
Bug Fixes
winapp runno longer pickscreatedump.exe(#496) — Fixed an issue wherewinapp runcould incorrectly selectcreatedump.exeover the intended application executable when multiple.exefiles existed. Detection logic is now shared withwinapp package.winapp register: accurate error for package-already-exists conflicts (#512) — HRESULT0x80073CFBwas being misreported as a Developer Mode error. The Developer Mode mapping is now correctly scoped to0x800704EC, and conflicts emit an actionable hint with the real package identity (parsed from the manifest).winapp unregister: safer per-package unregistration (#512) — Fixed two data-loss bugs: a per-package safety check that could be bypassed when multiple packages were classified together, and sibling-directory misclassification caused by a prefixStartsWithcontainment check. Rewritten as a two-pass classify-then-remove loop with segment-aware path containment.- Status output: real exception messages instead of
(null)(#512) — Failed operations now surfaceex.Message; falls back to"Operation failed without an error message."when no message is available. Stack traces are appended only at Debug log level. - NuGet version range parsing on cache-warm runs (#512) —
ParseMinimumVersionno longer silently breaks when brackets are pre-stripped (which only manifested aftergit cleanof.winappwhile the global NuGet cache still had the package). - WinAppSDK 2.0.1 forward compatibility (#512) — Supports the new major-only framework package naming (
Microsoft.WindowsAppRuntime.2instead ofMicrosoft.WindowsAppRuntime.2.0).
Compliance
- NuGet package metadata (#489) —
Microsoft.Windows.SDK.BuildTools.WinAppnow includes a compliant<Copyright>element required by Microsoft NuGet policy.
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration
Release v0.3.0
Version: 0.3.0
Commit: f3ce442ddd1ea2aea3ada40a0d7a5a2a411cfe00
New Features
winapp runcommand (#341) — Introduces thewinapp runcommand allowing developers to pack a folder and run their application as a packaged app, streamlining the process of launching packaged applications. Usage example:winapp run .\bin\Debug\net10.0-windows10.0.26100.0\win-x64 --manifest .\appxmanifest.xml
- UI automation with
winapp ui(#380) — Adds a new command group for UI automation, enabling programmatic interaction with UI elements in Windows applications using Microsoft UI Automation (UIA). Key commands includeui list-windows,ui inspect, andui click.
Bug Fixes
- Fallback in
get-winapp-path(#475) — Fixes an issue where the command would fail if the local cache was missing, now gracefully falling back to the global cache.
Installation Options
MSIX Installer (Recommended)
- Download
winappcli_x64.msixfor x64 orwinappcli_arm64.msixfor ARM64 - Double-click to install
- Automatically added to PATH
Standalone CLI Binaries
- Download
winappcli-x64.zipfor x64 orwinappcli-arm64.zipfor ARM64 - Extract to your desired location
- Add to PATH or run directly:
winapp.exe
NPM Package (for Electron or NodeJS)
npm install microsoft-winappcli.tgzWhat's Included
- MSIX installer packages (x64 and ARM64)
- Standalone CLI binaries (x64 and ARM64)
- NPM package for NodeJS/Electron integration