Console.Lib.Inspector
5.32.2871
{ "inputs": [ { "type": "promptString", "id": "CONSOLE_INSPECTOR_GROUP", "description": "Discovery multicast group override." }, { "type": "promptString", "id": "CONSOLE_INSPECTOR_PORT", "description": "Discovery multicast port override." }, { "type": "promptString", "id": "group", "description": "Discovery multicast group (default 239.255.77.91)." }, { "type": "promptString", "id": "port", "description": "Discovery multicast port (default 47892)." } ], "servers": { "console.lib.inspector": { "type": "stdio", "command": "dnx", "args": ["console.lib.inspector@5.32.2871+bfc6f27dccf352c21a2ee4183d2684d48cd8fd0c", "--yes", "--", "--group", "${input:group}", "--port", "${input:port}"], "env": { "CONSOLE_INSPECTOR_GROUP": "${input:CONSOLE_INSPECTOR_GROUP}", "CONSOLE_INSPECTOR_PORT": "${input:CONSOLE_INSPECTOR_PORT}" } } } }
.vscode/mcp.json settings file.
dotnet tool install --global Console.Lib.Inspector --version 5.32.2871
dotnet new tool-manifest
dotnet tool install --local Console.Lib.Inspector --version 5.32.2871
#tool dotnet:?package=Console.Lib.Inspector&version=5.32.2871
nuke :add-package Console.Lib.Inspector --version 5.32.2871
Console.Lib
A .NET library for building terminal applications with dock-based layouts, widgets, mouse/keyboard input, VT styling, and Sixel graphics rendering. AOT-compatible, targeting .NET 10.
This repo also ships mdcat — a cat-for-Markdown CLI built on the library (see below).
Features
- Dock-based layout — top/bottom/left/right/fill panels that recompute on terminal resize, built on DIR.Lib's surface-neutral
DockLayout<T>engine - Cell-surface layout —
CellLayoutpaints DIR.Lib's arrangedLayoutNodetrees (the same ones the pixel painter uses) to character cells, with click-region hit-testing - Widget system —
TextBar,TextInputBar,TextArea,ScrollableList<T>,TreeView<T>,Canvas<TSurface>,MarkdownWidget,MenuWidget - Sixel graphics — high-performance encoder (14× faster than ImageMagick's built-in Sixel writer); plus Unicode sextant and half-block fallbacks for terminals without Sixel
- VT styling —
VtStylewith 16-color SGR and TrueColor modes, automatic capability detection;StreamColorcolours a CLI's plain stdout or stderr (off when redirected or underNO_COLOR, Windows VT switched on per stream) - Markdown + LaTeX rendering — headings, tables, lists, fenced code, inline
[text]{color}syntax, OSC 8 hyperlinks for clickable links, inline + display math (\(...\),$$...$$,\[...\]),\ce{...}chemistry markup, and images (rasterized to Sixel / blocks, with alt-text fallback). Parsing is driven by LALR.CC grammars in DIR.Lib.Markdown; Console.Lib is the VT-output layer.MarkdownOutputwrites it to a CLI's standard output as mdcat does, with anOutputFormat(auto,rich,markdown,plain) for an--output-formatoption. - Input handling — unified keyboard + mouse events with UTF-8 codepoint decoding, SGR mouse tracking in alternate screen
- Menu system — arrow-key navigation, digit shortcuts, mouse support, alternate/normal mode
- Cross-platform — Windows VT I/O via Win32, native VT100 on Unix/macOS
Quick start
dotnet add package Console.Lib
var terminal = new VirtualTerminal();
await terminal.InitAsync();
terminal.EnterAlternateScreen();
var panel = new Panel(terminal);
var statusBar = new TextBar(panel.Dock(DockStyle.Bottom, 1));
var main = panel.Fill();
statusBar.Text(" Ready").Style(new VtStyle(SgrColor.BrightWhite, SgrColor.BrightBlack)).Render();
mdcat — cat for Markdown
mdcat is a tiny CLI that renders a Markdown file (or stdin) to styled terminal
output using Console.Lib's MarkdownRenderer — headings, bold/italic, lists, tables,
fenced code, OSC 8 hyperlinks, LaTeX math, and local images (Sixel / sextant /
half-block, auto-detected). Color support is auto-detected, with a richer GitHub-Dark
palette on truecolor terminals.
dotnet tool install --global mdcat # .NET global tool (needs the .NET 10 runtime)
mdcat README.md # render a file
cat notes.md | mdcat - # render from stdin
Prebuilt, self-contained native-AOT binaries (no runtime required) for Linux / Windows /
macOS on x64 and arm64 are on the Releases
page. See src/MdCat/README.md for all options, install methods,
exit codes, and math-font details.
Building
dotnet build src/Console.Lib
dotnet test src/Console.Lib.Tests
dotnet run --project src/MdCat -- README.md # build & run the mdcat CLI in place
Debug builds (Console.Lib.Debug)
ConsoleDebugInspector (the live inspector the Console.Lib.Inspector MCP sidecar drives) ships in the Release
Console.Lib too, from 5.27. It is inert: set DIR_INSPECTOR=1 and DIR_INSPECTOR_TOKEN=<a secret> in the app's
environment to start it, and run the sidecar with the same DIR_INSPECTOR_TOKEN, which it sends with every request.
With them unset nothing listens, and DIR_INSPECTOR=1 without a token refuses to start.
A trimmed or NativeAOT published app has no inspector at all unless it was published with
-p:DirInspectorSupport=true (DIR.Lib's feature switch, DebugInspectorCore.IsSupported): the default publish drops
the verbs and the command server, and DIR_INSPECTOR=1 then only prints one trimmed out of this build line on stderr.
tools/inspector-aot-probe is the proof.
Console.Lib.Debug is the same library at the same version, built Debug, and it depends on DIR.Lib.Debug; other
#if DEBUG types are only in it. Reference one or the other by configuration (Visual Studio needs a
restore after switching):
<ItemGroup Condition="'$(Configuration)' == 'Debug'">
<PackageReference Include="Console.Lib.Debug" Version="5.12.*" />
</ItemGroup>
<ItemGroup Condition="'$(Configuration)' != 'Debug'">
<PackageReference Include="Console.Lib" Version="5.12.*" />
</ItemGroup>
Documentation
See src/Console.Lib/README.md for the full API reference, architecture diagram, and detailed usage guide.
License
| Product | Versions 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. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 5.32.2871 | 0 | 11/16/2026 |
| 5.31.2861 | 0 | 11/16/2026 |
| 5.30.2841 | 0 | 11/16/2026 |
| 5.29.2821 | 0 | 11/16/2026 |
| 5.28.2801 | 0 | 11/16/2026 |
| 5.27.2781 | 31 | 11/16/2026 |
| 5.26.2761 | 31 | 11/15/2026 |
| 5.25.2741 | 29 | 11/15/2026 |
| 5.24.2721 | 26 | 11/15/2026 |
| 5.23.2691 | 30 | 11/15/2026 |
| 5.22.2671 | 26 | 11/15/2026 |
| 5.21.2641 | 27 | 11/15/2026 |
| 5.20.2621 | 31 | 11/15/2026 |
| 5.19.2591 | 33 | 11/15/2026 |
| 5.18.2561 | 31 | 11/15/2026 |
| 5.17.2521 | 32 | 11/15/2026 |
| 5.16.2481 | 33 | 11/15/2026 |
| 5.15.2441 | 29 | 11/14/2026 |
| 5.14.2401 | 28 | 11/14/2026 |
| 5.13.2371 | 32 | 11/14/2026 |