Repository navigation
v0.52.0
[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_referencesin 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_PLATFORMSended with "not a file of a knowledge level". It
now detaches the platform, after asking; its files stay where they are. tc_deletewithoutnameorparentPathsays 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 submoduleknowledge/: 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 arehigh(password in the code,__NEW
without__DELETE), sodoc --risks --fail-on highcan 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.jsonon 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 typingdelete all. Nothing is deleted: your knowledge, plugins and modules move to
%LOCALAPPDATA%\TcAgent\reset-<date>\, the connections leavesettings.json. Projects with their.tcagentstay 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": falseinupdates.jsonlocks 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 fortc_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 (answerLanguageinchat-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>.mdon 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|ba choice,=valuea default)
orparams:in the header (types text, number, choice, bool, pou = search list of POUs, GVLs and tasks; default, options,
required, help);tcagent-send: truesends 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_referencesis 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, orUnblock-File), extract it, runinstall-xaeshell.ps1(see docs/INSTALLATION.md)SHA256SUMS.txt- checksums of both packages
Full changes: v0.51.0...v0.52.0