Skip to content

v0.52.0

Choose a tag to compare

@ThorstenBrach ThorstenBrach released this 04 Nov 22:36
· 191 commits to main since this release

[0.52.0] – 2026-11-04

The built-in knowledge in this version is TcAgent_Knowledge 1.0.0.

Fixed

  • Visual Studio start: TcAgent blocked the IDE for up to 9 s, which could bring up the bar saying that it does not respond. The chat window
    started the agent while it was created, on the UI thread of the IDE (a cold start of the agent took 8.8 s). The agent, the search for its
    program and the setup check at the start now run in the background; the window opens at once and shows "starting", the agent follows when the IDE has loaded (a question
    sent before that starts it right away). The stall monitor of the extension ticks every 250 ms instead of 50 ms and no longer
    names a tool of a server that has ended; the log says how long the chat window and the agent start took.
  • tc_find_references in big projects: no answer within 60 s, the IDE hung (one report ended with a crash of the IDE, its cause
    is not known). The text search read every object through the Automation Interface, on the UI thread of the IDE. It now reads
    the project files (unsaved changes are not included, the result says so), the tree paths come from the same files, and the
    whole call answers within about 45 s: the cross references get 25 s and 8 s for reading them, a second query does not queue
    behind one still running, and the text search is returned in any case.
  • Knowledge window, tab Platforms: Delete on a platform connected through TCAGENT_PLATFORMS ended with "not a file of a knowledge level". It
    now detaches the platform, after asking; its files stay where they are.
  • tc_delete without name or parentPath says what is missing instead of "Value cannot be null (source)".

Changed

  • The built-in knowledge (skills, prompts, workflows, risk rules) now lives in its own repository
    TcAgent_Knowledge, included as the Git submodule knowledge/: every TcAgent version
    ships a known state of it. Nothing changes in the package; clone with --recurse-submodules.
  • Knowledge window: the tab Documentation is now Reference ("Manuals, datasheets and library docs the agent searches",
    tc_docs) - it is not documentation of TcAgent and not the templates. The texts of the window say "reference source".

Added

  • General TwinCAT risk rules shipped with TcAgent (knowledge/risk-rules/twincat-general.md): 11 rules and 21 agent checks for
    every project (several based on the Top 20 Secure PLC Coding Practices), in addition to the rules in the code. Pipelines: two of them are high (password in the code, __NEW
    without __DELETE), so doc --risks --fail-on high can fail where it passed before.
  • New versions in the TcAgent Chat (src/Updates.cs, vsbridge/ChatUpdates.cs, TcAgent.exe update): once a day, after the
    IDE has loaded, the extension asks GitHub for the releases (an anonymous request; pipelines and the agent never do). A newer
    version shows a line above the conversation and a dot on ⋯, What's new the release notes down to the installed version,
    with Download, Install, Open on GitHub, Skip this version and Later. The download only starts on a click and must match
    SHA256SUMS.txt of the release; Install opens the VSIX installer, nothing installs silently. The XAE Shell keeps the browser
    download and the documented steps of the ZIP. Switches in About; updates.json on the company or team level locks them.
  • Reset TcAgent (Knowledge window ⋯ > Reset TcAgent, TcAgent.exe reset): back to a fresh installation, to choose levels, platforms, sources and
    plugins again. Confirmed by typing delete all. Nothing is deleted: your knowledge, plugins and modules move to
    %LOCALAPPDATA%\TcAgent\reset-<date>\, the connections leave settings.json. Projects with their .tcagent stay as they are.
  • The knowledge repository as a predefined source: tcagent-knowledge (TcAgent_Knowledge) stands in the tab Sources from the start, so
    newer skills, prompts and rules can be installed between two versions of TcAgent. Nothing is read from it until somebody browses
    it or installs an item; it needs Git. Switch in ⋯ > About TcAgent, "knowledgeSource": false in updates.json locks it off.
  • Newer versions in the repo sources: once a day the sources in use are fetched (no pull, no sign-in window) and a line in the
    chat leads to the tab Sources.
  • About TcAgent (⋯ > About TcAgent, TcAgent.exe about --json): author, license, the versions of the extension, server, IDE and
    TwinCAT, the components with their licenses (the license texts in a window), the update switches. ⋯ also has Check for updates, which
    always answers in a dialog.
  • Shared folders in the TcAgent Chat (src/SharedFolders.cs, vsbridge/ChatShared.cs, TcAgent.exe shared): Attach … > Share a
    folder, a folder dropped on the input, or ⋯ > Shared folders. The agent reads these folders without asking; changing a file there
    still asks. A question decides for folders and files: only this chat, or kept in the knowledge for this solution or all
    solutions (a file as a copy). The list stays on this PC, goes with Backup and Restore, and kept folders are also Reference
    sources for tc_docs. Drives, the user profile, its key folders and system folders are refused, with the reason.
  • Answer language in the TcAgent Chat (⋯ > Answer language): the language of Windows (new default), the language of the
    question, or one of the languages of the Windows user (answerLanguage in chat-backends.json). Before, the answer
    followed the question, so prepared prompts in English gave English answers.
  • Prepared prompt /check-coding-rules: compares the open object with the coding rules, apart from the risk analysis.
  • Prompt list: right click Edit opens your own prompt, Edit my copy a copy of a built-in, company or team prompt on your level.
  • Prompt list: it keeps one height while it is open, also with another category or a longer preview, so the categories stay under
    the mouse. Many categories wrap and scroll from the fourth row on.
  • Prompt library (src/Prompts.cs, vsbridge/ChatPrompts.cs, docs/KNOWLEDGE_LAYERS.md):
    prepared prompts as a new kind of the knowledge - prompts\<name>.md on every level, kind Prompts in the Files tab
    of the knowledge window, from repositories through Sources, in the backups. In the TcAgent Chat / at the start of a
    line or the button Prompts opens a list above the input with search, categories and a preview; Enter inserts the
    prompt (it is not sent, it can be adapted), Ctrl+Enter inserts and sends. {object}, {selection}, {solution} are
    filled from the editor; other values are asked in a card: {input:…} in the text (|a|b a choice, =value a default)
    or params: in the header (types text, number, choice, bool, pou = search list of POUs, GVLs and tasks; default, options,
    required, help); tcagent-send: true sends right after the card; recently used prompts come first; Save as prompt … under
    an own message. Six neutral prompts are shipped, one example for every form. TcAgent.exe prompts [--json].

Known issues

  • The bar of Visual Studio about TcAgent can still appear on a start; blocks of several seconds remain while TwinCAT loads the project. Their
    cause is being looked at for 0.52.1.
  • tc_find_references is not yet confirmed on a very large project, also for 0.52.1.

Assets

  • TcAgent-0.52.0.vsix - Visual Studio 2022: double-click (close Visual Studio first)
  • TcAgent-XaeShell-0.52.0.zip - TwinCAT XAE Shell (preview): unblock the ZIP first (Properties > Unblock, or Unblock-File), extract it, run install-xaeshell.ps1 (see docs/INSTALLATION.md)
  • SHA256SUMS.txt - checksums of both packages

Full changes: v0.51.0...v0.52.0