Repository navigation
v0.50.0
[0.50.0] - 2026-11-01
Added
-
TcAgent with the TwinCAT XAE Shell alone (no Visual Studio 2022, no build tools) – preview: tested in the 32-bit shell
on a PC that also has Visual Studio 2022 (shell-only simulated withTCAGENT_IDE_ASSEMBLIES); a PC without Visual
Studio 2022 and the 64-bit shell are not tested yet. Every release gets the package
TcAgent-XaeShell-<version>.zip(built bybuild-vsix.ps1) with the extension prebuilt for the 32-bit shell
(bridge-vs15, built against the shell) and the 64-bit shell (bridge-vs17, the Visual Studio 2022 build - not tested
in that shell yet), the server andinstall-xaeshell.ps1. The script installs from the package without compiling and
copies the server into the extension's folder; on its first start the shell sets TcAgent up like Visual Studio does
(server to%LOCALAPPDATA%\TcAgent\app, interop from TwinCAT, AI clients after asking). -
install-xaeshell.ps1 -Vsix <file>: from the source, the server for the shell comes from a VSIX file instead of the VSIX
installed in Visual Studio 2022.-BuildOnlyalso checks a package. -
TcAgent.exe diagnames where the IDE automation (EnvDTE) was loaded from. -
TCAGENT_IDE_ASSEMBLIES: further folders with the IDE's automation assemblies (a shell installed elsewhere). -
Source control bindings warning: a solution still bound to TFS/VSS (the section in the .sln,
Scc*/SAK entries in the
project files,.vspsccfiles) made the IDE crash or refuse changes ("Cannot insert project") while TcAgent edited it -
tc_attachanddoctor --solutionnow warn and say how to unbind; TcAgent does not change these files. -
tc_plaintext/st import:fromPlc/--from-plc <name>- import a text folder that was exported from a PLC
project with another name; without it the warning lists the folders found. -
Delete feedback reports in the Feedback tab: Delete … (Del) asks first (default No) and then removes the selected
reports and their status records from the feedback file for good (TcAgent.exe knowledge feedback --action delete --key <ids>); the file is held exclusively while it is rewritten, other TcAgent processes retry their append. -
docs/UI_GUIDELINES.md – the UI/UX rules for every window and dialog of the extension (tabs and ⋯ menu, 4-6 main
actions, master-detail, states as symbol and word, long actions in the background, keys, empty states, check boxes,
visible safety information, vocabulary, privacy, theme colors, narrow windows, mockup before building); CONTRIBUTING.md
and the agent guide (agents/TCAGENT_GUIDE.md,SKILL.md) point to it. -
TcUnit progress block: the optional outputs
CycleandCyclesof the running test (shown as "cycle x/y"). -
The TcUnit window keeps the last 5 results of every test per solution (
%LOCALAPPDATA%\TcAgent\tcunit\history.json).
Changed
-
TcAgent.exeis built against EnvDTE 8.0 (NuGet EnvDTE 8.0.2 / EnvDTE80 8.0.3 instead of 17.0, plus stdole
7.0.3302 - Microsoft, Visual Studio SDK license as before, not shipped): it uses the EnvDTE of Visual Studio 2022 (17.0,
compatible) or of the 32-bit XAE Shell (8.0), which it now also finds in the shell's folder. Tested: "check" in a hidden
Visual Studio 2022 and in a hidden XAE Shell with the shell's own EnvDTE. -
Messages without a server name the XAE Shell way too.
-
Knowledge window reworked after a UX review (
vsbridge/KnowledgeWindow.cs):- Top bar with real tabs (the selected one underlined, a badge counts what needs attention there), the platform as a
short link, ⟳ (F5) and a ⋯ menu with Levels …, Backup now …, Restore …, Refresh and Copy diagnostics. - New tab Backups; History is now Workflow runs (with a note instead of an empty chart while there are fewer
than two runs). - Overview starts with what the agent gets in this project (each entry opens the Files tab with that kind) and
Needs attention (items from a source changed or newer, Git changes, documentation not reachable, open
blocker/major feedback) with links to the tab; rates show "—" and "needs 5 runs" until there are 5 runs. - States as symbol and word instead of a colored dot: ✓ applies, ↷ replaced, ⊘ switched off, ✎ changed locally,
↑ newer in the source, ⇅ both changed, ✗ missing, ⚠ not reachable, ○ empty. - Files: one toolbar row with Switch off ▾ (for this project / for me) and Source ▾, filters in their own row
(search with hint and ✕, Ctrl+F), kinds as words, a detail header with the fitting actions as links and the file
folded; the columns Git and Why only while a line has something in them (Source / license gets the room). - Sources: Browse and install … first and highlighted, rare actions under More ▾, Check for updates and Update
all next to the heading, Copy URL, the output folded while it is empty, empty states. - Browse and install dialog: search, kind filter, "Only not installed", state column (installed where, not
installable), details of the selected line, several items ticked with check boxes (the ticks stay when the filter
changes; Space ticks the line) instead of a Ctrl/Shift selection that one click beside it would lose. - Platforms: the decision for this project on top with Set for this project … and Detect automatically.
- Documentation: search like the agent right in the tab (Enter), state "○ empty – use Add documents …" in grey instead
of an error, shorter intro. - Feedback: "Show:" filter label, the issue text as an editable section with its own heading.
- Top bar with real tabs (the selected one underlined, a badge counts what needs attention there), the platform as a
-
The IDE stays responsive: every call of TcAgent.exe from the knowledge window runs in the background with a thin
progress bar; before, many actions (merge, propose, backup, restore, platforms, feedback text) blocked the IDE until
they were done. Calls from the background now also pass the open solution (it was missing there). -
Feedback: successes and hints in the status line or a yellow info bar below the tabs (with a link such as Open
folder) instead of a dialog to click away; errors stay dialogs. Long texts in confirmations (merge preview, update
plan, restore difference, install list) scroll; for risky steps Enter cancels. The status line shows on the right
what the tab holds. -
Buttons follow the selection: they are only enabled when they fit the selected entry (toolbar and context menu).
-
Keyboard: F5 refreshes and Ctrl+F jumps to the search box while the window is active (the IDE no longer takes
them); Enter opens and Del deletes in every list; toolbar buttons can be reached with Tab. -
Dialogs in the colors of the IDE (light, dark, blue), OK only when the input is valid (checked while typing, the
reason below the field), the restore choice and the backup list with a filter. -
TcUnit Tests window in the same style (
vsbridge/TcUnitWindow.cs):- Tool bar with words: Run all, Run selected (runs the ticked tests), Run failed, Stop, Report and ⋯ (Refresh F5,
Expand/Collapse all, Save/Load selection …). - The counters as labelled filter chips All / Passed / Failed / Off, next to the search (Ctrl+F).
- Progress line "Running · 4 of 18 · · about … left", afterwards "✖ 2 failed · 16 passed · 24 switched off ·
time · target …" in red or green. - Columns Test / Description / Result / Time instead of Duration / Traits / Error Message; the result as symbol and
word, for suites in words ("✖ 1 failed · ✔ 3 passed"). - Suites switched off for the run as one line "⊘ switched off (n)".
- A test over many cycles shows "◐ running · cycle x/y" (from the progress block) or its running time.
- Details like the HTML report: Expected / Actual / Message, code link, enable bool, Run again, Copy failure, the last
5 runs of the test; build errors of a run appear there too. - The legend of the symbols in the status line; colors for the light and the dark theme.
- Check boxes stay the way to choose tests – a click beside them loses nothing; a grey one says why ("no enable bool –
runs only with its whole suite or Run all"). - The root line says "runs suites in sequence" / "in parallel" instead of the TcUnit call; top right the state of the
runs with the target ("Not run yet · 9 tests · target: local runtime"). - Runs started elsewhere are shown too: a run started in the IDE (activate, login, start), by another client or
a pipeline on the target of the window appears live like a run of the window. New commandTcAgent.exe tcunit watch(the window starts it in the background): reads only over ADS – PLC state, TcUnit's progress and the enable
bools that decide which tests run; it writes, resets and starts nothing, and the target must be allowed like for
ads_read. Before, only runs of the window itself and oftc_test_runwere shown.
- Tool bar with words: Run all, Run selected (runs the ticked tests), Run failed, Stop, Report and ⋯ (Refresh F5,
-
TcAgent Chat in the same style (
vsbridge/ChatView.cs,ChatWindow.cs,ChatCards.cs,ChatAcp.cs):- The result of "Set up clients" as one line in an info bar ("TcAgent x is set up for n clients – restart the open
ones") with Details (left-aligned, user folders as %LOCALAPPDATA% / %USERPROFILE%) and Copy - no longer a
block of centered paths in the conversation. Other notices are one left-aligned line. - The start shows suggestions to click instead of a welcome text.
- The backend with a short name ("Claude Code") and a dot for its state: ready / starting or working / error (the
reason in the tooltip and the status line); a backend that starts per question is checked for its program. - Tool calls as compact lines: ◐ while running, ✓ / ✗ with the first line of the result and the time, details
(parameters and result), diff fortc_plc_write/tc_plc_create(the saved object against what the agent
writes, compare window). Claude's tool results are read now; Copilot (ACP) reports completed and failed calls. - Cards with Goal, Consequence and Gate, a filled primary button with the focus (Enter) and Esc for no;
Answer only when every question is answered; a card closed by New chat / Stop says so. - Runtime confirmations (TCAGENT_CONFIRM) as a gate card in the chat while a chat answer runs in the open window:
the target (AMS Net ID) in bold, a warning for a target that is not this PC, Execute / Don't execute. Safe by default:
Enter never confirms (the focus is on Don't execute, Enter and Esc cancel), Execute reacts only to a mouse click -
not to the keyboard or UI automation, so an agent cannot answer it; the card is scrolled into view. Without an open
chat window or a running chat answer the dialog stays (default No, the warning for a remote target as well). The
server passes the target and whether it is this PC to the bridge. - Input with a placeholder ("Ask Claude Code about this solution …"), a removable chip with the editor context that
goes with the question, attachments as chips, 📎 Attach …, the keys below the field in full (wrapped, never cut). - ⋯ menu grouped: Chat (editor context, check after changes, New chat, Copy conversation) / Windows / Setup and help
(Set up clients, Copy diagnostics, Open user guide) and the version line. - Status line: the backend state, while working "◐ … is working · n tool calls · time · last tool", afterwards
"✓ Done in … · n tool calls". - Esc stops the answer while the agent works; "Stopped by you" is a neutral line instead of a red error; answers
have Copy; errors are marked with ⚠ (not only red); Copy diagnostics no longer opens a message box.
- The result of "Set up clients" as one line in an info bar ("TcAgent x is set up for n clients – restart the open
-
Knowledge window: the actions on an item from a source are named My changes and What's new upstream; F2 renames
a file, Ctrl+C copies the path of the selected line in every list; long paths in the details are shortened in the
middle (Copy path copies the full one); red only for errors ("⇅ both changed", a worse trend and "not installable" are
orange).
Fixed
-
build-vsix.ps1could ship an older package: with aPlatformvariable in the console (e.g.x64) MSBuild writes to
vsbridge\bin\x64\Release, but the script only looked invsbridge\bin\Releaseand took a package left there by an
earlier build. It now takes the package this build wrote, wherever it is, and stops if there is none. -
Build warning IL3000 (
Assembly.Locationin the single-file build) inTcAgent.exe ciremoved. -
tc_test_resultsshowed FAILED details of earlier runs next to the summary of the last one: only the last run counts now
(and with TcUnit's per-test lines only tests that failed in it). -
tc_plc_createwith an IEC keyword, operator, standard function or type as name (e.g. methodAdd) only said "Name
mismatch": it now says why and suggests a name. -
tc_archivedescribed the archive as the whole solution:.tszipis the TwinCAT project (configuration with its PLC
projects) - TwinCAT HMI and Scope projects are not in it; the solution archive.tnzipis made in the IDE. -
tc_plc_searchover a large project could run until the client gave up and the IDE connection looked lost: a time
budget (default 40 s,secondsup to 240) returns the hits so far with a hint (narrow withpath, or search the
exported .st files).
Assets
TcAgent-0.50.0.vsix- Visual Studio 2022: double-click (close Visual Studio first)TcAgent-XaeShell-0.50.0.zip- TwinCAT XAE Shell (preview): unpack, runinstall-xaeshell.ps1(see docs/INSTALLATION.md)SHA256SUMS.txt- checksums of both packages
Full changes: v0.48.2...v0.50.0