AgentSpace.Avalonia.XTerm 0.0.1

Avalonia.XTerm

A 24-bit truecolor terminal control for Avalonia, the X11 PRIMARY clipboard companion, and two desktop tools built on both.

A Linux/Windows monorepo with two NuGet libraries and two dotnet tool apps. All four ship from the same v* tag.

<table> <tr> <td><img src="docs/screenshots/myterm.png" alt="MyTerm" width="460"></td> <td><img src="docs/screenshots/agentspace.png" alt="AgentSpace" width="460"></td> </tr> <tr> <td align="center">_{<b>MyTerm</b> — tabbed terminal, drag tear-off / merge, tint, profiles. Here it's rendering this very README to itself.}</td> <td align="center">_{<b>AgentSpace</b> — workspace launcher, SSH file tree, SQLite history. Sidebar tracks active and recent spaces.}</td> </tr> </table>

<details> <summary>_{more AgentSpace shots}</summary> <table> <tr> <td><img src="docs/screenshots/agentspace-files.png" alt="File tree + code preview" width="460"></td> <td><img src="docs/screenshots/agentspace-agent.png" alt="Agent + terminal" width="460"></td> </tr> <tr> <td align="center">_{File tree with transparent AvaloniaEdit code preview, syntax-highlighted via TextMate grammars.}</td> <td align="center">_{Agent / terminal split — Avalonia.XTerm hosting an agent CLI alongside a free shell.}</td> </tr> </table> </details>

What's in here

Quick start (library)

<Window xmlns:xterm="clr-namespace:Avalonia.XTerm;assembly=Avalonia.XTerm">
  <xterm:XTermControl Shell="bash" FontSize="14"
                      Background="#FF1E1E1E" Foreground="#FFCCCCCC" />
</Window>

Terminal.TitleChanged += (_, e) => Title = e.Title;
Terminal.BellEvent    += (_, _) => SystemSounds.Beep.Play();

Properties: Shell, WorkingDirectory, FontFamily, FontSize, Background, Foreground, CursorBlink, MaxScrollback, ColorScheme, BackgroundOpacity.

Events: TitleChanged, BellEvent, OutputReceived, SessionEnded.

Color schemes: ColorScheme.Default, Solarized, Dracula (swap at runtime).

Quick start (PRIMARY clipboard)

using Avalonia.PrimarySelection;

// Middle-click paste handler
var text = await PrimarySelection.GetTextAsync();

// Selection-complete handler
PrimarySelection.SetText(highlightedText);

Safe no-op on Windows / macOS / headless Linux. IsSupported tells you up front. The package ships a Windows / macOS stub plus a Linux-only X11 implementation under runtimes/linux/ — Windows binaries don't ship any libX11 metadata.

Repository layout

src/
├── Avalonia.XTerm/                  the public terminal control
├── Avalonia.PrimarySelection/       the X11 PRIMARY clipboard (stub variant)
├── Avalonia.PrimarySelection.Linux/ the X11 implementation (packed into runtimes/linux/)
├── Avalonia.AgentDebug/             Debug-only: HTTP/1.0 over named pipe so
│                                    agents can drive the running app via curl
└── VTDotNet/                        VT/ANSI parser sources, compiled INTO
                                     Avalonia.XTerm.dll — single self-contained DLL.
apps/
├── MyTerm/                          tabbed terminal app
└── AgentSpace/                      workspace launcher
samples/
└── BasicSample/                     ~10 lines — minimal embedding example
tests/
└── Avalonia.XTerm.Tests/            183 xUnit tests
scripts/
└── pack.sh                          builds ./artifacts/nuget/*.nupkg

Shared MSBuild config (authors, package metadata, SourceLink) lives in /Directory.Build.props.

Driving the apps from a shell (Debug builds only)

Avalonia.AgentDebug opens a Unix domain socket / named pipe per app and speaks HTTP/1.0. Built-in to Debug builds, completely absent from Release.

# Inspect the visual tree
curl --unix-socket /tmp/CoreFxPipe_MyTerm-debug http://_/tree

# Click a named control
curl --unix-socket /tmp/CoreFxPipe_AgentSpace-debug "http://_/click?path=NewSpaceButton"

# Save a screenshot
curl --unix-socket /tmp/CoreFxPipe_MyTerm-debug -o shot.png http://_/screenshot

# Send a key
curl --unix-socket /tmp/CoreFxPipe_AgentSpace-debug "http://_/key?path=PathBox&key=Enter"

(The screenshots at the top of this README were captured this way.)

Building / packing

dotnet build Avalonia.XTerm.slnx       # everything
dotnet test  Avalonia.XTerm.slnx       # 183 tests
scripts/pack.sh                         # all .nupkgs → artifacts/nuget/

Requirements

• .NET 10 SDK
• Avalonia 12.0+
• Linux, Windows, macOS for the library; PTY apps need Linux/macOS PTY or Windows ConPTY (handled by Porta.Pty).

License

MIT — see LICENSE. VTDotNet is a derivative of VtNetCore — MIT, attribution preserved in LICENSE.VtNetCore and NOTICE.md.