NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #797 most downloaded on NuGet
A library that makes it easier to create beautiful console applications.
Latest stable
0.57.2
Last release 4 months ago
02 Jul 2026
Ships unpredictably
gaps range from 8 days to 12 months
Some releases are documented
notes for 21 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
127 years old
68 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Allow wrapping of status text by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/2158
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.57.1...0.57.2
GH2153: Fix async stack traces rendering as MoveNext() instead of source methods by @devlead in #2154
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Make source generator output deterministic (LF, no BOM) by @phil-scott-78 in #2143
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.56.0...0.57.0
Ensure redirected output works as expected by @patriksvensson in #2098
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.55.2...0.56.0
Support variation selectors, ZWJ sequences and surrogate pairs in length calculation by @fabsenet in https://github.com/spectreconsole/spectre.console
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.55.1...0.55.2
Add tests to verify public API by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/2073
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.55.0...0.55.1
> There are breaking changes in this release, so make sure you review the release notes and try things out before upgrading in production.
This release brings new features, performance improvements, bug fixes, and some important architectural changes.
[!CAUTION] There are breaking changes in this release, so make sure you review the release notes and try things out before upgrading in production.
One of the biggest changes in this release is the introduction of
Spectre.Console.Ansi,
a new standalone library for writing ANSI escape
sequences to the terminal without taking a full dependency on Spectre.Console.
This makes it easy to add ANSI support to lightweight tools and libraries where pulling in the full Spectre.Console package would be overkill. Spectre.Console itself now depends on this library internally.
We've also added some nice convenience methods for the .NET Console class:
using Spectre.Console.Ansi;
Console.Markup("[yellow]Hello[/] ");
Console.MarkupLine("[blue]World[/]");
Console.Ansi(writer => writer
.BeginLink("https://spectreconsole.net", linkId: 123)
.Decoration(Decoration.Bold | Decoration.Italic)
.Foreground(Color.Yellow)
.Write("Spectre Console")
.ResetStyle()
.EndLink());
Style has been converted from a class to a struct, and link/URL information
has been extracted into a separate Link type. This improves allocation
performance, especially in rendering-heavy scenarios, but is a breaking change
for code that relies on reference semantics.
The Progress widget received a lot of love in this release. It now uses
TimeProvider instead of the wall clock, making it significantly easier to
write deterministic tests. ProgressTask has a new Tag property for attaching
arbitrary metadata, and you can now override the global hide-when-completed
behavior on individual tasks. Tasks can also be removed from the progress
context entirely.
Speed calculations have been improved with configurable max sampling age and sample count, giving you more control over how responsive or smooth the speed readout is. Speed calculations for stopped tasks have been fixed, and indeterminate tasks no longer show a meaningless time estimate.
Prompts now accept a CancellationToken, making it possible to cancel a waiting
prompt programmatically. TextPrompt default values can now be edited by the
user instead of being accepted or rejected as a whole. There is also a new
option to clear the prompt line after the user provides input.
Table body rows now support column spans, and a new minimal border style has
been added for a cleaner look. The Canvas widget gained half-block support,
which enables double the vertical resolution when rendering graphics. JsonText
now has a configurable indentation depth. Various performance improvements have
also been made to Markup instantiation and formatting.
A memory leak related to Segment has been fixed, along with
Segment.SplitLines ignoring multiple consecutive line breaks. A crash in
SegmentShape.Calculate when the lines list was empty has been resolved.
Interactive console detection when output is redirected now works correctly,
and table expand now properly respects fixed column widths. Truncation and
overflow handling for fullwidth characters has been corrected, and locking
performance on .NET 9.0+ has been improved.
This release contains several breaking changes. Please review the following before upgrading.
Style is now a struct. Code relying on reference semantics such as null
checks or reference equality will need to be updated. Related to this, link
and URL information has moved from Style to a new Link type, so any code
that reads or writes links through Style will need to be adjusted.
Several previously obsoleted members have been removed. The Alignment property
on Calendar, Table, and Grid, as well as the Render extension method,
no longer exist. AnsiConsoleFactory has been made static and internal, so code
that instantiated this class directly will need an alternative approach.
Finally, ANSI output is now disabled when stdout or stderr is redirected. This is a behavior change: output that previously included ANSI escape codes when piped or redirected will now be plain text.
Style by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/2013Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.54.0...0.55.0
Version 0.54.0 of Spectre.Console has been released!
Version 0.54.0 of Spectre.Console has been released!
We've decided to move Spectre.Console.Cli to its own repository, where we will prepare it for a 1.0 release. This means that the Spectre.Console.Cli NuGet packages will no longer be versioned together with Spectre.Console. They will now have a preview version such as 1.0.0-alpha-0.x.
There should be no issues staying on version 0.53.0 of Spectre.Console.Cli until we release a stable version if you prefer not to use a pre-release dependency.
There is now a new testing package for Spectre.Console.Cli called Spectre.Console.Cli.Testing. This is where you will find the CommandAppTester from now on.
You can find more information about unit testing in the documentation.
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.53.0...0.54.0
This is a hotfix release for 0.53.0, which accidentally included OpenCli.Sources as a dependency, instead of being included in the package.
This is a hotfix release for 0.53.0, which accidentally included OpenCli.Sources as a dependency, instead of being included in the package.
As a bonus, a fix for panels was also included in this release 😄
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.53.0...0.53.1
This is a hotfix release for 0.53.0, which accidentally included OpenCli.Sources as a dependency, instead of being included in the package.
As a bonus, a fix for panels was also included in this release 😄
Full Changelog: 0.53.0...0.53.1
0.53.1 (hotfix) Pre-release
Pre-release
Compare
Add top-level CancellationToken support to Spectre.Console.Cli by @0xced in #1911
Add OpenCLI integration to Spectre.Console.Cli by @patriksvensson in #1909
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.51.1...0.52.0
Fix IndexOutOfRangeException in ExceptionFormatter by @martincostello in #1800
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.50.0...0.51.1
Nothing published for this version
Strong name the assemblies by @KirillOsenkov in #1623
HtmlEncoder Incorrectly Applying Italics to Bold Text by @z4ryy in #1590Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.49.1...0.50.0
Nothing published for this version
Cleanup line endings by @nils-a in https://github.com/spectreconsole/spectre.console/pull/1381
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.48.0...0.49.0
Version 0.48 of Spectre.Console has been released!
Version 0.48 of Spectre.Console has been released!
Several rendering issues have been addressed, such as fixing problems related to rendering inside status causing corrupt output, avoiding exceptions on Rows with no children, as well as addressing rendering bugs in TextPath.
New features have been added, such as the ability to show separators between table rows. Other notable additions include progress bar header and footer support, customizable (and localizable) help providers, and the option to style text and confirmation prompts.
end_of_line to LF instead of CRLF by @0xced in #1256Rule widget docs by @tomaszprasolek in #1257BreakdownChart by @nils-a in #1303TextPath rendering bugs by @patriksvensson in #1308AnsiConsoleOutput safe height by @0xced in #1358DefaultValueStyle() and ChoicesStyle() by @0xced in #1359ConfirmationPrompt Styling by @wbaldoumas in #1210[NotNull] attributes by @0xced in #1255FileInfo and DirectoryInfo by @0xced in #1238showcase sample by @AndrewRathbun in #1315columns sample to showcase nicer data by @nils-a in #1295SetErrorHandler to SetExceptionHandler by @nils-a in #1298Generator project compiles by @patriksvensson in #1371Add Alacritty to the supported terminals in AnsiDetector by @MaxAtoms in https://github.com/spectreconsole/spectre.console/pull/1211
StringComparer by @MartinZikmund in https://github.com/spectreconsole/spectre.console/pull/1161TextPrompt by @MartinZikmund in https://github.com/spectreconsole/spectre.console/pull/1152params syntax by @seclerp in https://github.com/spectreconsole/spectre.console/pull/1166Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.46.0...0.47.0
Add support for .NET 7.0 by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/1056
Layout widget by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/1041@ being used in Figlet font by @Saalvage in https://github.com/spectreconsole/spectre.console/pull/972PACKET key on MultiSelectionPrompt by @nilaoda in https://github.com/spectreconsole/spectre.console/pull/1012TypeConverterHelper, TextPrompt and AnsiConsole by @sowa705 in https://github.com/spectreconsole/spectre.console/pull/1014IndexOf replaced by Count at Add method - Performance issue #975 fixed by @maije in https://github.com/spectreconsole/spectre.console/pull/1096]]] at the end of a style by @nils-a in https://github.com/spectreconsole/spectre.console/pull/1027CommandArgument required/optional style in template parameter docs by @ArveSystad in https://github.com/spectreconsole/spectre.console/pull/1090BreakdownChart by @BenjaminMichaelis in https://github.com/spectreconsole/spectre.console/pull/1000Panel documentation by @patrickfreilinger in https://github.com/spectreconsole/spectre.console/pull/1016Rows widget by @Elisha-Aguilera in https://github.com/spectreconsole/spectre.console/pull/1038Grid widget by @Elisha-Aguilera in https://github.com/spectreconsole/spectre.console/pull/1043Padder widget by @Elisha-Aguilera in https://github.com/spectreconsole/spectre.console/pull/1046Columns widget documentation by @wguner in https://github.com/spectreconsole/spectre.console/pull/1044Panel documentation by @bcwood in https://github.com/spectreconsole/spectre.console/pull/1068SixLabors.ImageSharp by @FrankRay78 in https://github.com/spectreconsole/spectre.console/pull/1073Layout by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/1127Wcwidth.Sources to v1 by @renovate in https://github.com/spectreconsole/spectre.console/pull/969actions/setup-dotnet action to v3 by @renovate in https://github.com/spectreconsole/spectre.console/pull/982Microsoft.NET.Test.Sdk to v17.3.2 by @renovate in https://github.com/spectreconsole/spectre.console/pull/977cake.tool to v2.3.0 by @renovate in https://github.com/spectreconsole/spectre.console/pull/1015Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.45.0...0.46.0
Move Spectre.Console.Cli to its own package by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/827
Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.44.0...0.45.0
Added the ability to hide CommandOptions. by @twaalewijn in https://github.com/spectreconsole/spectre.console/pull/642
TextPath widget by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/757Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.43.0...0.44.0
Update sponsors.md by @mgnslndh in https://github.com/spectreconsole/spectre.console/pull/584
Render from docs in favor of Write by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/613null by @nils-a in https://github.com/spectreconsole/spectre.console/pull/620Full Changelog: https://github.com/spectreconsole/spectre.console/compare/0.42.0...0.43.0
Use browser context for social cards by @phil-scott-78 in https://github.com/spectreconsole/spectre.console/pull/490
char and string by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/523AnsiConsole.Write method by @patriksvensson in https://github.com/spectreconsole/spectre.console/pull/577Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.