AgentSpace.Avalonia.XTerm 0.1.7

AgentSpace

An Avalonia 24-bit truecolor terminal control, an X11 PRIMARY-selection clipboard, and two desktop tools built on both.

A Linux/Windows monorepo with three NuGet libraries and two dotnet tool apps. All five 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 — the XTerm control hosting an agent CLI alongside a free shell.}</td> </tr> </table> </details>

What's in here

Quick start (library)

<Window xmlns:xterm="clr-namespace:AgentSpace.Avalonia.XTerm;assembly=AgentSpace.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 AgentSpace.Avalonia.PrimarySelection;

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

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

Safe no-op on Windows, macOS, and headless Linux. IsSupported tells you up front whether PRIMARY is available. The package ships a Windows / macOS stub plus a Linux X11 implementation under runtimes/linux/ — Windows and macOS binaries don't carry any libX11 metadata.

Repository layout

src/
├── AgentSpace.Avalonia.XTerm/             the terminal control
├── AgentSpace.Avalonia.PrimarySelection/  X11 PRIMARY clipboard (stub variant)
├── AgentSpace.Avalonia.PrimarySelection.Linux/
│                                          X11 implementation (packed into runtimes/linux/)
├── AgentSpace.VtDotNet/                   VT/ANSI parser, separate assembly
└── Avalonia.AgentDebug/                   Debug-only: HTTP/1.0 over named pipe
                                           so agents can drive the running app via curl
apps/
├── MyTerm/                                tabbed terminal app
└── AgentSpace/                            workspace launcher
samples/
└── BasicSample/                           ~10 lines — minimal embedding example
tests/
└── AgentSpace.Avalonia.XTerm.Tests/       526 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 into 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 AgentSpace.slnx       # everything
dotnet test  AgentSpace.slnx       # 526 tests
scripts/pack.sh                    # all .nupkgs → artifacts/nuget/

Requirements

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

License

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