Repository navigation
Releases
Termwright v0.40.1
- README: a demo - a short animation at the top and a 1-minute video: a switch, the AI, the emulated lab, a traffic run and its report.
- Releases come with a
SHA256SUMSfile and a build provenance attestation, so a download can be checked against what GitHub built from this repository (Verifying a download). - Project files for contributors: a security policy with private reporting, CONTRIBUTING.md, a code of conduct, and forms for bug reports and feature requests.
- CI runs more tests:
go veton all Go packages, the app's tests and the Python client's tests, asmake testdoes. - Docs: architecture diagrams in colour, with the traffic engines and TRex in the main one, and a new Traffic generation diagram: the two engines on each host, test ports on switch ports, host network ports and TRex, and how the counters come back.
- Docs: a FAQ (docs/FAQ.md): how Termwright compares with SecureCRT, VS Code, GNS3, EVE-NG, Containerlab and TRex; why it uses AI and Wails; how credentials are protected; what reaches the AI service; what the MCP server exposes; how the lab works across hosts; and how it is built.
- Builds: the Android APK no longer fails when Maven Central rate-limits (HTTP 429): the Gradle downloads are cached between runs, and the build waits and tries again twice.
Commits
- Tests: the restart script test fakes sudo too, so it passes on CI runners that have passwordless sudo (1adb73c)
- Release 0.40.1 (7af87d9)
- README: demo animation at the top and a 1-minute video; AI screenshots without the switch OS banner (fbe33d8)
- Screenshots: the AI panel as in 0.40 - asking about a terminal, the message box, the agent's permissions (9ff4b6c)
- Screenshots: the 0.40 interface - start page, AI agent, tiled sessions, files panel, Session Manager, session panel (51d3ea2)
- Project: security policy, contributing guide, code of conduct, issue forms; releases with SHA256SUMS and build provenance; CI runs vet on all packages, the app and Python tests (0f0c01e)
- Docs: colour architecture diagrams; traffic engines and TRex in the main one; new Traffic generation diagram (c942039)
- Docs: FAQ without the limitations list; install notes for macOS signing and the Android preview APK (4c7f119)
- Docs: FAQ - comparisons with other tools, AI and data, credentials, MCP, multi-host lab, how it is built, known limitations (56a4f8a)
- Builds: cache the Android build's Gradle downloads and retry when Maven Central rate-limits (HTTP 429) (801750f)
Full changelog: v0.40.0...v0.40.1
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.40.0
- Linux: one title bar, in Termwright's theme. The window has no system title bar and no GTK menu bar any more: Termwright's own title bar has its logo, the menus (File, Edit, View, Transfer, Lab, Script, Options, Tab, Help - themed like the rest, with their shortcuts) and the minimise, maximise and close buttons. The window still moves by its title bar and resizes at its edges; a narrow window keeps the menus under ⋯.
- Status bar as on classic terminals: the cursor's line and column, the selection (rows or columns, and characters), the terminal's rows and columns, its type, and CAP and NUM (Caps Lock and Num Lock).
- The terminal bar's toggles are icons, as in VS Code's panels: timestamps (a clock), scroll lock (a lock: open while new output follows, closed when the view stays) and clear (which now asks first) - each with a tooltip.
- The AI chat's message box, as VS Code's chat: a tip on top, the model and its effort in the box, a quiet send button, and under it the AI service, the mode (Agent, Plan, Ask) and the agent's permissions as plain chips; the mode menu has the permissions too, and Changes ask first is marked Recommended.
- Start page: the search bar has the same edge, face and corners as the buttons under it.
- Hide the Session Manager from itself: a hide button beside its ⋯ (the Sessions strip at the side shows it again) - more room for the emulated lab. The title bar's sidebar button is gone.
- Terminal bar: always there - no ✕ to hide it by mistake (Global Options → Terminal hides it for every tab), an icon that is on is just blue (no frame), the clear icon is an eraser, and Auto scroll is off · Turn On no longer covers the output while the bar shows - the blue lock says it (the notice stays when the bar is hidden).
- The Emulated Lab guide (docs/EMULATOR_GUIDE.md): step by step from the KVM host (Ubuntu, KVM on hardware or nested in a VM) to Set Up, images and appliances, a qcow2 image from an ISO, a topology on the canvas, several hosts, traffic and a complete test - and the same with the AI agent. The AI assistant knows it too.
- Linux: the tabs on a row of their own, under the menus and buttons - as on macOS, where the menus are at the top of the screen.
- Fixed: Check for Updates did not offer the nightly after a release: a release is a merge of develop into main, so the newer nightly is not "ahead" of its tag but "diverged" from it; that counts as newer now (when it changes more than documentation). A 0.39.0 install still has the old check: download that one nightly by hand.
- Fixed: local builds and the nightly's notes named 0.36.0 after 0.39.0: releases are tagged on main, so the newest release tag is found by its version, not by what develop reaches. The start page shows 0.39.0 nightly again.
- Start page: GitHub at the bottom is white, with a gold star.
- Updates: the Advanced section (another repository and a GitHub token, for a fork) is gone.
- Source layout: the desktop app's Go files moved from the top of the repository into
app/(package app);main.goalone stays at the top - it embeds the window, the guides and scripts and starts the app - so the GitHub page shows the folders and the README without a long list of files first. Builds and the API are unchanged;go test ./app/runs the app's tests.
Commits
- Release 0.40.0 (0b9b984)
- Terminal bar always shown (no hide button, no per-tab toggle); Global Options still hides it for every tab (3447333)
- Terminal bar: icons on are plain blue, an eraser for clear, no scroll-lock notice over the output while the bar shows (2beccbb)
- Emulated Lab guide (host to first test, and with the AI agent); Linux tabs on a row of their own; title bar sidebar button removed; Check for Updates offers the nightly after a release (df2fffb)
- Session Manager: a hide button beside its menu; nightly and local builds find the newest release tag by version (0.39.0, not 0.36.0); start page GitHub link white with a gold star; Updates without the fork settings (e4114a9)
- Source layout: the desktop app's Go files in app/, only main.go at the top of the repository (f9d6754)
- Linux: one title bar in Termwright's theme with the menus and window buttons; status bar with cursor, selection, size, terminal type, CAP and NUM; icon toggles on the terminal bar (clear asks first); AI chat box as VS Code's; start page search bar like its buttons (6c9b08a)
Full changelog: v0.39.0...v0.40.0
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.39.0
- Quick streams and tests. The Traffic page's + L2 Stream, + L3 Stream and Quick Tests… open one dialog: choose an L2 or L3 stream, a custom frame, or a ready test - latency, jitter, loss under load, RFC 2544 throughput, bad packets, fuzz, VLAN isolation, MTU and jumbo frames, 802.1X clients - answer a few questions (which test ports, whether the switch ports carry the VLAN tagged, whether the switch has IP interfaces in the two subnets) and What Termwright fills in lists every stream and every change to a test port before anything is made, each one editable. Create or Create and Start. An L3 stream gives each test port an address and the switch's IP interface as its gateway, and says what the switch needs to route.
- Custom frames, without Scapy. A stream's Type can be Custom: paste the frame in hex (Wireshark's Copy as a Hex Stream, a Scapy hexdump, any hex dump); Termwright puts in the test ports' MACs, works out IP and UDP/TCP lengths and checksums per frame (or leaves your bytes as they are) and adds its counting signature, so custom frames are counted and timed like any other.
- User-defined fields: bytes at an offset that count up or down, or are random, from frame to frame (1 to 4 bytes), in any stream, as hardware testers have them.
- Faults and fuzzing: 23 malformed frames (bad IP or L4 checksum, wrong lengths, TTL 0 and 1, IP options, fragments, martian and broadcast sources, LAND, TCP SYN+FIN, Xmas and no flags, multicast or zero source MAC, runt, VLAN 4095, two tags, unknown EtherType), and random bytes over a range of offsets with a seed to repeat a failure. A stream's frames can now be dropped to pass (a filter or a fault the switch drops), or only be counted. The API, the connector, the AI chat and Python's
add_streamtakekind=custom,hex,udfs,bad,fuzz,expect,no_fixandno_sig. - Traffic reports to share and keep: HTML, PDF and Excel. Report ▾ on the Traffic page saves an HTML report (one page, nothing outside it), a PDF (printed by Chrome, Edge, Chromium or Brave on the computer, nothing to install) or an Excel workbook with Excel's own charts, or the CSV as before. The report shows the verdict and totals, the topology with each stream as a numbered arrow between its test ports, the throughput, loss and latency graphs, and for each stream the frames sent (its settings) beside the output received (counts, loss, latency percentiles and histogram, the VLAN, priority and DSCP frames arrived with, flows), with the first frame sent and the first received decoded side by side - what the switch changed on the way (MACs and TTL when routed, a VLAN tag) is marked - and as hex dumps; then the test ports. The workbook has the same in sheets (Summary, Graphs, Frames sent, Output received, First frames, Flows, Test ports, Timeline, Topology). The API's report takes
format=pdfandformat=xlsxtoo. - More protocols on test ports. PEAP-MSCHAPv2 for 802.1X clients (a TLS tunnel to the RADIUS server and MS-CHAPv2 inside, as Windows clients log in; the lab's RADIUS server answers it with a certificate Termwright makes), DHCPv6 for clients behind a test port, VRRP (v2 and v3: the test port as a second router for the switch's virtual address; Go Silent times how fast the switch takes over, Take Over takes it back) and BFD (a single-hop session with the switch; Go Silent for 5 s times how fast the switch notices). Quick Tests has DHCPv6 clients, VRRP failover and BFD failure detection, and the 802.1X test asks for the method. The test port cards show VRRP and BFD, and the clients list their IPv6 addresses.
- Headers on streams: QinQ, MPLS, GRE, VXLAN and IPv6 extension headers. The stream editor shows a stream's headers in wire order; + Header ▾ adds an outer VLAN tag, up to three MPLS labels, a GRE or VXLAN tunnel or IPv6 extension headers (hop-by-hop, destination options, segment routing, fragment). The frame size stays the size on the wire. Reports decode them all, with the frame inside a tunnel as Inner ….
- Fixed: the bottom pane's Traffic tab saved reports as HTML only: it has the same Report ▾ (HTML, PDF, Excel, CSV) as the Traffic page now, and saved test runs can be saved as PDF too.
- Real TCP sessions. A stream's Type can be TCP Session: real connections from a test port to another (or to an address) with the handshake, data both ways (retransmitted when lost) and FIN - how many, how many at once, how fast, how much data, plain or HTTP - and what should happen to them: connect, be refused (reset) or get no answer. Results: tried, connected, refused, timed out, reset, setup time (avg, p95, max), sessions a second, the most open at once. Quick Tests… has TCP sessions and Blocked TCP port (ACL).
- The fast engine. Engines… on the Traffic page chooses what sends the streams on the KVM hosts: the built-in engine (Python) or the fast one, a compiled helper built into Termwright for Linux x86-64 and ARM64 and copied to the hosts' lab folders - the same streams, counters and reports, about four times as fast: 420,000 frames a second of 64 bytes and 2.5 Gbit/s of 1518 bytes with no loss on two vCPUs (the built-in one: about 100,000). Streams can ask for up to 2,000,000 frames a second with it. The measured numbers are in docs/PERFORMANCE.md.
- Test ports on real switches. A KVM host's spare network card cabled to a real switch can be a test port (+ Test Port → Host network card): streams, sessions, protocols, tests and reports work on it as on the lab's switches. Cards that are the host's own network, have an address or are in a bridge are not offered; the engine needs root or passwordless sudo there.
- TRex servers. For line rate on real hardware, Termwright drives TRex (stateless mode) over its API - nothing installed on the TRex server: Engines… → + TRex Server… shows its version and ports, and a ticked port is a test port. Streams between two of its ports are sent and counted by TRex (UDP, TCP SYN, ICMP, raw, ARP, custom; VLAN, DSCP, IMIX, changing fields) with latency on a copy, and show in the same results and reports. Tested against a simulated TRex server.
- The report's topology draws real devices that test ports are cabled to (dashed) beside the lab, and session streams with their sessions instead of frames.
- API, connector and Python:
GET/PUT /lab/traffic/engines,GET /lab/traffic/nics,POST /lab/traffic/trex,DELETE /lab/traffic/trex/{server}, test ports withhost/nicortrex/trexPort, streams withkind: "session"; the connector'slab_traffichasengines,set_engine,nics,add_trexandremove_trex; Python hasset_engine(),nics(),add_host_port(),add_trex()andadd_trex_port(). - RADIUS: Many Users… adds numbered users in one go (user1…user100, or user001… with digits), with the number in the password too if you like (pass{n}) and a VLAN; the 802.1X clients test adds them for you.
Commits
- Release 0.39.0 (5f7905d)
- Traffic: real TCP sessions, the fast engine, test ports on a host's network card cabled to a real switch, TRex servers; benchmark published (2b20f6e)
- Traffic: PEAP-MSCHAPv2, DHCPv6, VRRP and BFD on test ports; QinQ, MPLS, GRE, VXLAN and IPv6 extension headers on streams; Report menu in the bottom pane too (b831e8a)
- Traffic reports: HTML, PDF and Excel with topology, graphs, frames sent and received (dbfb4eb)
- Traffic: quick streams and tests, custom frames, user-defined fields, faults, fuzzing, expect dropped; RADIUS many users (64b060f)
Full changelog: v0.38.0...v0.39.0
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright nightly (1adb73c)
Automatic build of develop (1adb73c). Untested - back up your settings first (the update window has Back Up Now).
Commits
- Tests: the restart script test fakes sudo too, so it passes on CI runners that have passwordless sudo (1adb73c)
Full changelog: v0.40.1...1adb73c
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.38.0
- README and feature list: the GitHub page now shows Termwright as it is - access, AI (the agent and the MCP connector), the network emulation lab and traffic generator, automation and teams - with new screenshots of the lab, the traffic generator and the start page.
- Teams: Members on their own page. A team's card has Members… next to Open Admin Page and Leave: the members, their roles and the invite open on a page of their own (with Back), and each member stays on one line. The team's buttons sit on its name's line, so an update notice gets the card's full width.
- Fixed: Update the Team Server - This Termwright's (0.37.0) ran over Nightly build; each choice is now as wide as its words.
Commits
- README: dark theme throughout - the team pictures are the admin page's inventory and the Members page in dark; the light gallery picture gives way to Tell Me When It Is Free (014dd87)
- Release 0.38.0 (5372bbe)
- Screenshots: the start page as it is now (the platform line and Collaborate), dark, light and the README's first picture (616c72d)
- README and feature list: Termwright as it is now - access, AI (agent and MCP connector), the network emulation lab and traffic generator, automation and teams; new lab screenshots (e25e7fa)
- README and feature list: Termwright as it is now - access, AI (agent and MCP connector), the network emulation lab and traffic generator, automation and teams; new lab screenshots (6306ec0)
- Teams Members page: Russian strings (0cb954a)
- Teams: Members on their own page; team buttons on the name's line; Update the Team Server's version choices no longer overlap (83011ee)
Full changelog: v0.37.0...v0.38.0
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.37.0
- 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
developbranch, whose builds are the nightly; releases are tagged onmain.
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.
Termwright v0.36.0
-
Start page: the line beside the name says AI-powered network access, automation, emulation and reservation platform (it wraps in a narrow window instead of being cut off) over SSH · Telnet · Serial · SFTP · RDP · VNC · WoL · Discover · Teams, a little dimmer, and the footer Built for the people who design, operate, and troubleshoot networks. Both are a little smaller and a softer white.
-
About: three more cards - AI Agent (autonomous configuration and troubleshooting in your sessions and labs; MCP connector), Emulate (virtual labs) and Collaborate (team server: shared inventory, who is on a device, reservations, usage) - three to a row in a wider window, a new introduction, raised buttons with icons like the start page's, and Star on GitHub and Share (on LinkedIn) beside Copy Link; Created by moved beside Close, easier to read.
-
Team server: model, serial number and MAC on Inventory. The admin page's Inventory has Model, Serial # and MAC columns (searched and exported to CSV too). The team server reads them itself: it logs in to EXOS, VOSS and Cisco IOS devices over SSH (or Telnet), turns paging off, runs the show commands and logs out, with the Device logins on Discover - one per kind of device, the factory defaults until an owner or co-owner sets others (EXOS admin with no password, VOSS rwa). Devices are read when they are added (from a scan, + Add device or Import CSV; can be turned off), and any time with Read Device Facts for the selected devices. A refused login shows as login failed on the device, with the reason on hover. The logins stay on the team server; members never get them. Members' Termwright also sends the serial number and base MAC (with the hostname and model) when it reads them, so devices are filled in without the logins too. A grey MAC was only seen on the network; the device's own base MAC replaces it once read.
-
Captures (from the user's screenshot): the packet's detail under the table has a ✕ (and Esc) to close it; while a capture runs the table keeps the newest packets in view - at the bottom, followed unless you scroll up to read - and Newest First puts them at the top instead (kept for next time).
-
Open Web Page Through This Session: the page is tried through the session first - when it cannot be reached, Termwright says why instead of opening a browser on nothing (an SSH server with TCP forwarding off, as on EXOS and VOSS switches; a name the device cannot resolve; no answer). A name the device cannot resolve (a switch without a DNS client) is resolved on this computer and reached by its address. Device types have a Tunnel setting: EXOS, VOSS and Cisco IOS do not forward by default, so the menu item is off for their sessions ("no forwarding") and the dialog points to Open Web Interface or a Linux session instead.
-
Emulated lab, Server (from the approved mock-up): a palette node next to the PC - an Alpine computer with HTTP, FTP and TFTP from one shared folder, DHCP on its port 1 (range, gateway, DNS, lease, boot file and TFTP server) and SSH/SFTP; its services answer on the management address too (EXOS:
download url http://<server>/<file> vr VR-Mgmt), DHCP only on the data port. Its side pane: services on/off with their settings, how to reach it, the shared folder (Upload… from this computer, Download, Folder…, Delete with check boxes) and the DHCP leases; service badges under it on the canvas. The first server installs its packages once and becomes the Server image, so later ones start offline. Connector: lab_server (add, show, set, upload, delete). -
Emulated lab, microcontrollers (from the approved mock-up): ESP32-S3, ESP32-C3, ESP32-C6 and ESP32-H2 as lab devices. Add Firmware… (Appliances) takes a flash image or an ESP-IDF build folder; the firmware is drawn as a dev board under Microcontrollers; it runs in Espressif's QEMU on the KVM host (downloaded from its newest release and checked against its SHA-256) with its UART as the console session, its flash kept, a GDB server on request and Flash to another firmware. They now also run on this computer (Hosts → Add → This computer, macOS or Linux: an SSH connection inside Termwright, no port or login; Espressif's QEMU downloaded once), have Ethernet on port 1 for lab cables (Espressif's OpenCores MAC,
openethin ESP-IDF), and the ESP32-C3 offers MicroPython, downloaded from micropython.org when it is first dropped on the canvas (or Add Firmware → Get MicroPython) - the S3 and C6 builds stop in Espressif's QEMU, so they get no sample. Tried on a Mac (macOS 26, arm64): This computer, the QEMU download with its SHA-256, the Homebrew message and the start worked; the console was silent because Espressif's UART drops output while nothing is connected, so Termwright now keeps every board's console from its first instruction (it starts paused) and relays it to the console sessions. The Hosts page shows this computer as a microcontroller host (no KVM checklist or Set Up). The flash size follows the firmware header. The lab's status checks work on a Mac too (sysctl, vm_stat and ps where Linux has /proc). The connector has lab_microcontrollers (list, this_computer, sample, add, flash), and lab_console types on a board's UART without a login. -
Open Web Interface reads the device's web server (the user's request): for EXOS and VOSS sessions the dialog logs in in the background and shows whether HTTP and HTTPS are on; Turn On HTTP and HTTPS… shows the device's commands, runs them and saves the configuration (EXOS:
enable web http, a self-signed certificate,enable web https,save configuration; VOSS:web-server enable,no web-server secure-only,save config), then the address follows (https:// once HTTPS is on). The commands and the patterns that read the state are part of the device type (Global Options → Device Types), so other device types can have them too. Background commands can now answer a device's (y/N) question when the user approved them. -
Emulated lab, from the user's screenshots: in the light theme the switches are dark silver (white on a light canvas before) in every style but Boxes; a CPU meter over 100 % (QEMU's own threads count too) stops at its track and turns amber instead of running over the number; the lab bar shows the switches' states as round count badges (5 up, 1 off…) instead of a bar; a switch's hover card goes where it fits in view - right, left, below or above - never over the switch; the captures list has a check box on each stopped capture and Select all, Delete is red and the confirmation's Delete is red too (no tiny ✕); a running capture's Stop pulses slowly; the management capture badge is blue like a captured cable.
-
Session properties → Jump Host / Proxy: with a jump host or proxy set but turned off, a small square showed on the left of its switch (the greyed section also greyed the switch's hidden check box, making it visible). Fixed.
-
Open Web Interface on a switch that serves only HTTP: the address is offered as https://, but an EXOS switch serves only HTTP (port 80) until HTTPS is turned on (
show management: "Web access: Enabled (tcp port 80)"), so the page would not connect. Termwright now checks the route first: when port 443 does not answer and port 80 does, it opens http:// and says why. -
AI chat finished: a microphone in the message box starts the system's dictation there (macOS Dictation, Windows voice typing with Windows+H; elsewhere a hint); the empty chat explains Agent and Ask; the old layout's leftovers are gone.
-
Session properties: side panel or full window (issue 5; pictures for approval): the welcome screen asks where a session's properties open, with a picture of each - A side panel (the everyday fields, More Options… for the rest) or A full window (every page at once); Settings → General → Session properties changes it later.
-
AI chat, like VS Code's chat (issues 10, 12, 15; screenshots for approval): your messages as bubbles on the right; the agent's steps as one line (Ran 3 commands on core-1, acc-1) that opens to them, its questions always in view; copy, model and time under each answer. The model picker (model · effort, with every version) moved from the top into the message box next to + (add context), the mode, the tools and send; what the agent may do sits under the box. Agent is the default mode and plans: a task of several steps gets a checklist plan, pinned above the message box, that fills in as it goes. Plan mode looks with read-only commands and writes the plan; Run the Plan carries it out. The mode is kept.
-
Open Web Interface reaches the device (issue 6): a device without a jump host or proxy - an emulated switch on the host's network, say - opened in the default browser, which follows the system's or the company's web proxy; that proxy cannot reach a lab or management address, so nothing arrived at the device. It now opens in a browser window of its own whose traffic goes straight from Termwright, the way the SSH session connects (the default browser only when no Chrome, Edge, Chromium, Brave or Firefox is there). Install from ISO: an automatic Alpine install needs a disk of at least 1 GB and makes no swap partition (100 MB and 500 MB disks ran out of space making the boot files, after the erase question was answered).
-
Emulated lab, Traffic → Statistics (from the approved mock): every test port's counters in one table, grouped by host (a virtual chassis each, with its rates and load) - link, frames per second and Mbit/s each way, frames sent and received, loss of the frames that were for the port, latency, errors and the last minute of its rates; a port's streams and a stream's flows below it; Streams and Flows views; live every second, Freeze, Clear counters, Columns, sorting, folding a host and Export CSV. Also in the ...
Termwright v0.34.1
A fix for the team admin page.
- Team admin: Discover check boxes. Ticking a scanned device (or select all) could do nothing when the page refreshed while the mouse button was down - mostly in Safari. The boxes now keep their listener across refreshes, and the page waits until the click is handled before drawing itself again.
Commits
- Release 0.34.1 (0aa161a)
- Team admin: Discover check boxes keep working when the page refreshes during a click (Safari) (7b0b3bd)
Full changelog: v0.34.0...v0.34.1
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.34.0
Name sessions after their devices, a Network Check from this computer and the device tabs, a firewall check for the file servers, calmer folder colours, and who is free now on the team admin page.
- Name After Devices. Sessions named by their address get the name the device gives itself. Right-click a folder → Name After Devices… reads each hostname and model in the background and renames them in one go (hostname, hostname (model) or hostname · last octet, editable, with Undo). After connecting, a session named by its address is offered the device's name - or renamed automatically with Undo (Settings → General → Sessions named by an address). A new Hostname device fact for EXOS, VOSS, Cisco IOS and Linux. Team servers learn each device's hostname and model from members' Termwright and from scans; owners rename devices on Inventory → Name After Devices, and Usage reports show the device's own name with its address and a Model column.
- Network Check (Transfer → Network Check…): who can reach what - this computer and the open device tabs (their own read-only ping, typed in the tab) against gateway, DNS, internet and any host or
host:port, as a matrix with a hint where a device misses what the computer reaches. A cell opens the path: Traceroute shows each hop and where the answers stop. Speed (iPerf3): an iperf3 server on this computer with the command for the device, and a test to any iPerf3 server both ways. - Network Check on switches: management VR. A device no longer pings its own address (it said it could not reach itself), and when the default VR or VRF does not answer, the ping and traceroute are tried in the management one (EXOS VR-Mgmt, VOSS MgmtRouter, NX-OS management) - an address only reachable there is no longer shown as unreachable. Packet transmit error now reads no route.
- File servers: firewall check. The File Servers window shows whether this computer's firewall (macOS, Windows Defender, ufw, firewalld) lets devices reach Termwright, allows it with one click (the system asks for an administrator password), and Test from proves a device can fetch a file from this computer.
- Team admin: who is free now. Usage reports have a Now column - free, in use (by whom) or reserved (by whom, until when) - sortable, in the CSV export, and Only free now lists the devices you can open or reserve right away.
- Calmer folder and environment colours. Soft (the new default: softer folder colours by level, tinted PROD / LAB tags), Vivid (the colours until now, solid tags) or Steel blue (blue-grey by level, outlined tags) - Settings → General → Folder colours, and on the Welcome screen. Your own environment colours are toned the same way.
Commits
- Release 0.34.0 (48d3d84)
- Name After Devices: rename address-named sessions to the device's hostname (folder dialog, offer after connect, automatic with Undo); team server learns hostname and model, owners rename on Inventory, Usage reports show them (7175864)
- Network Check: a device does not ping itself; retry in the management VR/VRF (EXOS VR-Mgmt, VOSS MgmtRouter, NX-OS management) (5483ab7)
- Team admin: Now column in Usage reports - free, in use or reserved - with Only free now (f64d290)
- Network Check: reachability matrix from this computer and device tabs, traceroute path, iPerf3 server and client (2cfabb2)
- Folder colours: Soft (default), Vivid or Steel blue, in Settings and on the Welcome screen (3cdf72f)
- File servers: firewall check, Allow Termwright and a test from the device (1faa48c)
Full changelog: v0.33.0...v0.34.0
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.
Termwright v0.33.0
An AI assistant and agent beside the terminal - with your own Claude login or any AI service - built-in TFTP, FTP and HTTP servers, single sign-on for teams, and one modern window.
- Restore from Backup… (Settings → General → Backup, next to Back Up Now): pick a backup zip; your current settings are backed up first, Termwright closes, and the backup is put back when it starts again (files that are not in the backup stay).
- AI chats are kept in the data folder (
ai-chats.json, readable only by you) instead of the window's own storage, so backups include them; the chosen agent tools are a setting now (backed up, exported and synced). Both move over by themselves. - The Classic layout is removed (toolbar, tab strip, in-window menu bar, Connect Bar). Everyone gets the modern window: every menu command is in the title bar's ⋯ menu (and the macOS menu) with the same shortcuts, and View → Connect Bar opens Quick Open. Settings that chose Classic open the modern window; nothing else changes.
- Start page buttons in three styles - Raised (the default: a thick edge, they lift and press down), Keycaps (like keyboard keys, with the shortcut) or Glow cards (a round icon glowing in the action's colour). Each action has its own colour. Choose in Settings → General or on the Welcome screen.
- Settings → AI Assistant: Model is a drop-down list of the models the service offers (loaded when opened, readable names such as Sonnet 5.5), and you can still type a model name. For Claude Code it lists the newest of each family (Opus, Sonnet, Haiku…) and every version the installed Claude Code knows (read from the program, nothing sent).
- Claude Code effort (Low, Medium, High, Extra high, Max, or the model's default) in Settings → AI Assistant and in the AI panel's model menu; the panel shows the model and effort in use.
- Switches look right: the knob is centred and fills the switch (a border from the text-box style pushed it down).
- Start page: at most 12 cards in Favourites and Recent together - favourites first, recent sessions fill the rest (Show all still lists every recent session).
- AI panel instead of the AI window: a chat beside the terminal - docked right or left, or floating - with follow-up questions, chat history, a large typing area, pasted pictures, and Add context (selection, copied text, whole terminal, other tabs, files).
- AI Agent: fully autonomous mode (orange; the other levels are yellow, Read only white). The agent runs commands and configuration changes without asking - production sessions still ask before every command and connection, and reboot / reload / erase always ask. It confirms once when chosen.
- AI Agent works on groups of devices: it finds saved sessions by folder (location), name, address or device type and connects by name, path or IP with the saved login (never sent to the AI); a chip per device shows its progress, and commands the device refuses are flagged. A connection that fails is reported at once instead of after a timeout.
- AI Agent tools Logger and Recorder: it logs and records the tabs it works on (a marker per command), also in Read only.
- Choose the AI model in the AI panel (the chip in its header); answers show the model that wrote them (Claude Code reports it, e.g. Sonnet 5.5).
- Fixed: the AI agent permission was not kept after restarting Termwright.
- AI panel: tokens, New Chat, agent tools. Each answer shows the tokens sent and received (as Claude, OpenAI-compatible services, Ollama and Claude Code count them), the chat its total, and the typing area an estimate before sending. New Chat sits under the header and in Chats. In Agent mode the wrench button chooses the tools (run commands in tabs, connect to saved sessions) and each answer lists the tools it used. Claude Code now answers in JSON, which gives its token counts.
- AI Agent mode: the AI connects to saved sessions and runs commands in your tabs to find a problem or fix it. Read-only commands (per device type, editable in Device Types) run by themselves; anything else shows the exact command to Run, Edit, Skip or Stop; production sessions always ask; or choose Ask before every command / Read only.
- Start page cards: the time and the open/closed dot move to the top right while the quick buttons show.
- Start page cards: the card under the pointer comes forward smoothly (no more tilting) and shows quick buttons - Connect, Open in SFTP, Copy the address, More; the long path tooltip that covered the next card is gone.
- Settings → AI Assistant redone as three clear groups - AI service (with a Ready / Not working status and Test), Privacy, and Claude connector (Added / Not added for Claude Desktop and Claude Code, set up by hand).
- Claude Code as the AI service - your own Claude login, no API key: Termwright runs the Claude Code program on your computer (without tools) for Explain and Ask.
- Use Termwright from Claude Desktop and Claude Code (Settings → AI Assistant → Use Termwright from Claude): Termwright becomes a connector (MCP server). Claude can list your open tabs and saved sessions and read a tab (passwords, keys and SNMP communities removed); it can open a session or type a command only after you allow it in Termwright (each time, or for 15 minutes in a tab; changes always asked, with a warning) - or never. Add to Claude Desktop / Add to Claude Code set it up; it listens on this computer only, with a random key.
- AI button in the title bar (sparkles; also Options → AI Assistant…): it opens the AI window for the open tab, or the AI settings while no service is set up (a small amber dot). The window sends the selected text, the copied text, the whole terminal (screen and scrollback) or the tabs in the send group - the selection when there is one, otherwise the whole terminal - with how many lines and tokens that is and a warning for long text (keep only the last 200 / 500 / 1,000 lines). Ask your own question about it, or one click on Explain this, Find problems, Summarise or Commands to fix it.
- Team admin page, Discover: Network devices only and Hide devices already in the inventory now always untick (the page no longer redraws while a mouse button is down, which lost the click) and are remembered in the browser.
- EXOS port states in colour. In
show ports/show port no-refreshthe Network keyword set colours Port State E (enabled) green and D (disabled) amber, Link State A (active - up) green and R (ready - down) red, like up / down for other systems. Existing settings get it once; only rows that start with a port number are coloured. - File servers: TFTP, FTP and HTTP (Transfer → File Servers…). Devices fetch software images and licences from a folder on this computer and send their configurations to it - no separate TFTP or FTP program needed. Listens only on the address you choose (the one that reaches the open tab's device is picked for you); uploads only when you allow them; nothing outside the folder can be read or written; a live list of transfers, refusals included. The window writes the command for the device (EXOS, Cisco IOS and NX-OS, Arista EOS, Junos, Linux, or your own per device type) and pastes it into the tab. The status bar shows the running servers and the progress; they stop after 30 minutes without transfers and when Termwright closes.
- Single sign-on for teams (Microsoft Entra ID first; Okta, Google and any OpenID Connect service). The owner sets it up on the admin page's Single sign-on (with the Entra steps and the redirect address to register); members choose Join with Microsoft in Termwright and sign in in the browser. Allowed e-mail domains and groups, the invite key kept or not, and a sign-in again every few weeks (30 days by default) so people who left drop out. The ID token's signature, issuer, audience, expiry and nonce are checked, PKCE is used, and another account cannot take over a member.
- AI assistant (optional, off by default). Right-click in a terminal: Explain with AI explains the selected output or error, Ask AI for a Command gives the commands for the tab's device type. Choose the service in Settings → AI Assistant: Claude (your API key), an OpenAI-compatible service (OpenAI, Azure OpenAI, a company gateway) or Ollama (local - nothing leaves your network). Passwords, secrets, keys, SNMP communities and tokens are removed before sending (and, if you want, addresses and host names); the window shows what was sent; commands are pasted without Enter or saved to the Command Library.
- Escape over the terminal. Escape closes the right-click menu and a dialog also when the keyboard focus is in the terminal behind them (it went to the device before).
- Faster with big session trees. The Session Manager reloads in 80 ms instead of 0.8 s with 20,000 sessions (unchanged files are not read again), and the sync's half-minute check reads only files that changed. Measurements and how to repeat them: docs/PERFORMANCE.md.
- Team server for big teams. The usage history is written in the background every 15 seconds instead of on every change; last used goes to members only when it changed; large answers are compressed; requests may be up to 16 MB (a backup to restore up to 256 MB - before, restoring the backup of a busy team failed at 1 MB). With 200 members and 5,000 devices, everyone's heartbeat is answered within half a second.
Commits
- User Guide: new start page picture, a terminal with the AI assistant and a VNC desktop (20952c6)
- Restore from Backup, AI chats in the data folder, agent tools as a setting (2c7f7b7)
- Release 0.33.0 (6a97964)
- Remove the Classic layout: one modern window; saved Classic settings open it (d043820)
- Start page buttons: Raised (default), Keycaps or Glow cards, chosen in Setti...