Skip to content

v0.50.0

Choose a tag to compare

@ThorstenBrach ThorstenBrach released this 01 Nov 16:01
· 229 commits to main since this release

[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 with TCAGENT_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 by build-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 and install-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. -BuildOnly also checks a package.

  • TcAgent.exe diag names 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, .vspscc files) made the IDE crash or refuse changes ("Cannot insert project") while TcAgent edited it -
    tc_attach and doctor --solution now 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 Cycle and Cycles of 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.exe is 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.
  • 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 command TcAgent.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 of tc_test_run were shown.
  • 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 for tc_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.
  • 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.ps1 could ship an older package: with a Platform variable in the console (e.g. x64) MSBuild writes to
    vsbridge\bin\x64\Release, but the script only looked in vsbridge\bin\Release and 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.Location in the single-file build) in TcAgent.exe ci removed.

  • tc_test_results showed 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_create with an IEC keyword, operator, standard function or type as name (e.g. method Add) only said "Name
    mismatch": it now says why and suggests a name.

  • tc_archive described the archive as the whole solution: .tszip is the TwinCAT project (configuration with its PLC
    projects) - TwinCAT HMI and Scope projects are not in it; the solution archive .tnzip is made in the IDE.

  • tc_plc_search over a large project could run until the client gave up and the IDE connection looked lost: a time
    budget (default 40 s, seconds up to 240) returns the hits so far with a hint (narrow with path, 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, run install-xaeshell.ps1 (see docs/INSTALLATION.md)
  • SHA256SUMS.txt - checksums of both packages

Full changes: v0.48.2...v0.50.0