Repository navigation
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 Settings and on the Welcome screen (ee05cfc)
- AI: model versions and Claude Code effort in Settings and the AI panel; switches with a centred knob (91e9c12)
- Settings → AI Assistant: the model is a drop-down list you can also type in (20f1376)
- Start page: at most 12 cards for Favourites and Recent together (ec1ab11)
- AI agent: fully autonomous mode with production guard, groups of devices by folder or address, Logger and Recorder tools, model choice in the panel (747af39)
- AI panel: token usage per answer and per chat, New Chat button, agent tools choice and tools used (49c90d2)
- AI panel: chat docked right/left or floating, history, pictures, Add context; Agent mode runs commands in tabs (read-only by itself, changes after approval, production always asks); card time and status move to the top right on hover (c50832c)
- Start page cards: smooth zoom on hover with quick actions (Connect, SFTP, Copy, More), no tilt or path tooltip; Settings → AI Assistant as grouped lists with status and Test (3d926f8)
- Claude Code: say so when only Claude Desktop's sandbox copy (claude-code-vm) is there (55ef044)
- Claude Code: also found where Claude Desktop, nvm, Volta and the native installer keep it (checked with --version); Check shows the path (aba94e2)
- Claude Code as the AI service (your Claude login, no API key); Termwright as a connector (MCP server) for Claude Desktop and Claude Code: list tabs and sessions, read a tab, open a session and run a command after you allow it (0f81889)
- AI button in the title bar (opens the AI settings until a service is set up); the AI window sends the selection, the clipboard, the whole terminal or the selected tabs, with a token warning and your own question (dc4cefc)
- EXOS port summary in colour (E/D port state, A/R link state like up/down); team admin Discover filters untick reliably and are remembered (6978668)
- File servers: TFTP, FTP and HTTP on this computer for devices to fetch images and licences and send configurations (Transfer → File Servers…): one folder and address, uploads only when allowed, transfer log, device commands for EXOS, Cisco, Arista, Junos, Linux or your own, status-bar indicator, idle stop (a2fab55)
- Single sign-on for teams (OpenID Connect: Microsoft Entra ID, Okta, Google): set up on the admin page, Join with Microsoft in Termwright, allowed domains and groups, sign in again every few weeks; ID tokens verified (signature, issuer, audience, expiry, nonce) with PKCE (e0133db)
- AI assistant (optional, off by default): Explain with AI and Ask AI for a Command with Claude, an OpenAI-compatible service or Ollama; secrets removed before sending, commands pasted without Enter or saved to the Command Library; Escape closes menus and dialogs also from the terminal (8ac745c)
- Performance with big trees and teams: Session Manager reloads read only changed files; sync checks only changed files; team server writes usage in the background, sends last-used only when changed, compresses large answers, allows larger requests (restore of big backups); performance tests and report (3a5c519)
Full changelog: v0.32.0...v0.33.0
macOS: the app is ad-hoc signed, not notarized - after installing run xattr -dr com.apple.quarantine /Applications/Termwright.app.