Skip to content

Termwright v0.37.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 18:38
· 34 commits to main since this release
  • Connect an AI app: Help → Connect an AI App… (and the AI panel's model menu) opens the connector's settings, now AI apps (MCP connector). Besides one-click Add for Claude Desktop and Claude Code, Other AI apps copies a ready config with this computer's path to Termwright for Cursor, Windsurf, Gemini CLI and most others, VS Code or Codex CLI, and says where each app keeps it. Used by shows which AI apps used Termwright since it started (their names as the apps give them), how long ago, how many tools they ran and the last one. Nothing to download: the connector is Termwright itself.
  • A Lab menu in the menu bar: Emulated Lab, Simulated Lab, and straight to the emulated lab's Overview, Traffic Generator, Appliances and KVM Hosts (the labs were under Transfer).
  • The emulated lab's pages have icons: Canvas, Overview, Traffic, Appliances and Hosts each show a two-tone icon in its own colour above the name, with the count on the icon's corner.
  • Traffic page: the test ports and the three charts sit on the same seven columns as the cards above them (test ports one, each chart two), and a small rate axis no longer reads 0, 1, 1, 2.
  • Installed from ISO: Size is what the image file takes (273 MB of an 8 GB disk), not only the disk it was given; ← goes back to the page before, and from an image opened there back to the list.
  • Start page: the line under the name reads … Discover · Collaborate, and the line at the bottom is as dim as it.
  • Fixed: frame sizes count the FCS, as testers and RFC 2544 do: a 1518-byte frame went out 4 bytes too long (1522 with its FCS), so a switch with the usual MTU dropped every one and RFC 2544 found no rate without loss at 1518 bytes; 64-byte frames were 68.
  • Fixed: a test port got no frames from its switch when the switch port had a cable when the switch started and the cable (or the switch at its other end) was removed since: the port still sent to the old other end, so the test port counted 100 % loss although the switch forwarded every frame. Termwright now reads where the port really sends (QEMU's monitor, once per switch start) and the test port listens there; when the old other end still runs, or was on another host, the Events and the test port say to restart the switch once.
  • The traffic generator no longer drops its own frames with several fast streams: it sent up to 4,000 frames per stream before reading the ones coming back, so two streams of 50,000 frames a second lost a quarter of them at the receiving test port; it now sends at most 2,000 a round over all streams, and three streams of 40,000 arrive whole. The user guide has its measured speed (How fast the generator is): about 93,000 frames a second of 64 bytes, 52,000 of 1518 bytes (640 Mbit/s) on one 2.1 GHz CPU, sent and received with no loss.
  • The AI assistant knows Termwright. Asked whether Termwright can do something, where a setting is or how a feature works, it looks it up in the guides of the version running - only the sections that match - instead of guessing (it said no team presence existed; it does). Asked about Termwright's state now, it reads it: the version, each KVM host with its CPUs, memory and the VMs on it, the labs, who has which team device open or reserved, the file servers and the open tabs. Both only read, so they work in every mode (Ask too); the Claude connector has them as termwright_help and termwright_status.
  • The AI has full control of the emulated lab: it can remove devices (lab remove, lab_remove in the connector) - stopped, their disks, cables and (unless told not to) sessions gone, kept in the lab's history with Revert - and the chat agent now takes every lab tool Termwright has (hubs, servers, history, checkpoints, ISO installs…), not a fixed list. Read only still refuses changes.
  • Install from ISO: the form stays on the left and the running install on the right, so the page no longer scrolls; its steps fold into one line. You answer the installer from the page: every installer asks its own questions (EXOS's rescue menu waits for c), so the installer's console shows under the install with a line to type an answer and keys for Enter, Space, Esc, Tab, the arrows and Ctrl+C - through the console's session when it is open in a tab. Installs that ended are on their own page, Installed from ISO, with Open image and Remove. The two ways to install read Alpine (automatic) and Other (by hand). What you type reaches the installer also while an automatic install holds its console, and choosing an ISO picks Other (by hand) unless its name says Alpine. Take Over by Hand turns an automatic install into one by hand without losing what the installer wrote (an EXOS ISO started as automatic installs, then waits for an Alpine login that never comes) - also after a restart of Termwright stopped its typing, while the installer still runs.
  • Team server Inventory: Columns and sorting. Columns chooses which columns the table shows (Device always): MAC and Folder are hidden at first - a hidden device type or model is shown under the address - and the choice is kept in that browser; Default columns goes back. Every column sorts with a click on its heading (again for the other way; empty values stay last), so the table fits without scrolling sideways.
  • Builds: new work goes to the develop branch, whose builds are the nightly; releases are tagged on main.

Commits

  • Release 0.37.0 (df9616d)
  • Connect an AI app: Help menu and AI panel entry, a ready config for other MCP apps (Cursor, Windsurf, Gemini CLI, VS Code, Codex), and Used by - which AI apps used Termwright and when (372c0a9)
  • Installed from ISO: the table stays inside its card, names on one line (d72543d)
  • User guide: the measured speed through a switch, 1518-byte frames included (fba74ba)
  • Lab menu; icons on the emulated lab's pages; Traffic page on one 7-column grid; Installed from ISO shows the image file's size and has Back; start page: Collaborate, dimmer bottom line (2a629f9)
  • Traffic generator: frame sizes count the FCS (a 1518-byte frame was 1522 and dropped by switches); the speed through a switch in the user guide (2c5790d)
  • Test ports listen where their switch port really sends: a port that started with a cable since removed still sent to the old other end, so the test port got no frames (4ea883e)
  • Traffic generator: at most 2,000 frames a round over all streams, so several fast streams no longer overflow the receiving socket; its measured speed in the user guide (4d165f9)
  • Install from ISO: Take Over by Hand keeps an automatic install's progress and goes on by hand (also after a restart stopped its typing); several running installs stack (93d9038)
  • Install from ISO: typing reaches the installer while an automatic install holds its console; an ISO not named Alpine starts as by hand (63f1f64)
  • AI assistant: looks Termwright up (help: the guides of the version running; status: version, KVM hosts and the VMs on each, labs, teams, file servers) in every mode; full control of the lab (lab remove, every lab tool) (ca6e5aa)
  • Install from ISO: form left, running install right with its console to answer the installer (a line and keys); finished installs on their own page (ea6f47d)
  • Builds: nightly from develop only; main builds on release tags (7323ea5)
  • Screenshots and examples: internal lab addresses and names replaced with neutral ones (22 screenshots edited, an unused one removed) (57457f1)
  • Screenshots and examples: internal lab addresses and names replaced with neutral ones (22 screenshots edited, an unused one removed) (f2aafb5)
  • Neutral examples: lab addresses and names in docs, placeholders, comments and tests replaced (no change in behaviour) (3910b53)
  • Neutral examples: lab addresses and names in docs, placeholders, comments and tests replaced (no change in behaviour) (fe63e49)
  • Branches: nightly builds come from develop; releases are tagged on main (15717bc)
  • Team admin Inventory: Columns picker (MAC and Folder hidden at first, kept per browser) and sorting by every column (f766be1)
  • Team admin page: check boxes work with a chosen theme; Discover rows tick on a click anywhere on them (58f84f3)

Full changelog: v0.36.0...v0.37.0

macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.