Repository navigation
[0.55.0] – 2026-11-17
The built-in knowledge in this version is TcAgent_Knowledge 1.1.0 (unchanged).
Added
- Clean up TcAgent's files - Knowledge window, tab Storage: what TcAgent keeps under
%LOCALAPPDATA%\TcAgentper area
(chats, attachments, TcUnit runs, logs, caches, server versions, downloaded updates,*.bak-*, files of ended processes)
with size, oldest, rule and what the rule removes; Clean up … shows every item first and uses the recycle bin; per
project Delete everything of this project …. Once a day the safe areas are cleaned in the background. Rules in
settings.json"retention"; never touched: backups, knowledge, settings. CLI:TcAgent.exe storage [clean|auto|project-delete]. - Install updates from the chat, also in the XAE Shell - Install … closes the IDE (it asks to save), installs the
package (VSIX installer, or the XAE Shell ZIP withinstall-xaeshell.ps1) and starts the IDE again with the same solution;
the XAE Shell now downloads its ZIP from the release itself (update download --kind xaeshell, checked against
SHA256SUMS.txt). Test builds:TCAGENT_UPDATE_FOLDERnames a folder with built packages; one there is offered when it
is newer or the same version built again (anotherTcAgentBridge.dll), with Skip this build (update local). - Chat history, stage 2 - ⋯ > Earlier conversations … lists the saved conversations of the solution (read, continue,
delete); a continued conversation goes on in the agent's own session when the backend is the same and the session is still
there (Claude Code--resume, ACPsession/load), otherwise with the summary as before. The history now also keeps your
answers to question cards and the id of the agent's session. - Newer built-in knowledge without a new TcAgent - the TcAgent Chat looks once a day for newer tags of the knowledge
repository and shows what changed; Use x.y.z makes that version the built-in level (cache under
%LOCALAPPDATA%\TcAgent\builtin), Skip this version, and ⋯ > About TcAgent goes Back. Only versions this TcAgent can
use are offered ("Needs TcAgent" in their changelog); the package stays the fallback and pipelines always keep it
(TCAGENT_BUILTIN=package).updates.json:"builtinUpdates": falseor"builtinVersion": "1.1.0". CLI:
TcAgent.exe update builtin [check|apply|skip|back]. Your copies of built-in, company or team files show
↑ original changed in the Knowledge window when their original changed, with Compare. - TcUnit report and window: tables in the test texts -
///lines that start and end with|are shown as a table
(first line the head, a|---|separator line is left out, number columns right-aligned) in the HTML report, light and
dark, and in the details of the TcUnit Tests window, e.g. the step table of a path test. - Chat history per solution - for every backend of the TcAgent Chat (Claude Code, GitHub Copilot, Gemini, Codex):
the chat keeps every conversation on this PC (%LOCALAPPDATA%\TcAgent\chats\<solution>-<hash>\, never in Git):
questions, answers, one line per tool call, a stop, and the agent's task list where the backend reports one (Claude
Code, ACP backends such as Copilot). Opening the solution again shows the last conversation;
within 8 hours the next question continues it. The first question to the agent gets a short summary - questions, last
answer, open tasks - and the new tooltc_chat_history(read, list, search) reads more, with every AI client. Kept 90
days / 50 per solution; ⋯ > Delete chat history of this solution;"saveHistory": falseinchat-backends.json
switches it off. The chat now also follows a solution change of the IDE (new session in the new folder).
docs/USER_GUIDE.md - Knowledge window: several items at once in every list - select with Shift or Ctrl, the actions of the bar and the
context menu work on all selected lines with one question. Sources (installed): My changes, Update and merge (every
preview first, conflicts in the merge window), What's new upstream, Revert, Keep as own version, Uninstall, Copy path,
"Select all like this"; Files: Open, Move to level, Switch off/on, Delete, Copy path and the Source actions; Backups and
Reference docs: Delete and Copy path; Platforms: Copy path; Modules: Switch on / Switch off. Actions for one item (rename,
edit, propose, open folder) are grey while several are selected. - TcUnit shipped with TcAgent - TcUnit 1.3.2 (MIT license,
thirdparty\TcUnitwith its license next to
TcAgent.exe, listed in THIRD-PARTY-NOTICES.md).tc_library action=ensure_tcunitinstalls it into the TwinCAT library
repository only if TcUnit is missing or older there (a newer one stays) and adds the reference to the PLC project if it
has none;TcAgent.exe tcunit ensure --solution <sln>does the install for pipelines and reports the reference.
doctornow also finds TcUnit in the library folder of TwinCAT 4026 (PlcEngineering\Managed Libraries). - Condition window: rewrite it, truth table - ⤢ in the Inline-Logic-View or Tools > Rewrite condition (TcAgent) ...
Tab Rewrite: NOT inward (De Morgan), NOT inward with the comparisons turned (NOT (a < b)→a >= b), NOT outward,
simplify, write out in full,= TRUEuniform or removed - before and after in the look of the editor, laid out with the
formatter rules of the project, each proven over every combination and the code read again and checked; Apply
replaces the condition in the editor in one step (Ctrl+Z takes it back). Tab Truth table: when it is TRUE or every
combination (up to 10 sub-conditions), the combination of now marked, copy as a table. Tab Sub-conditions: value now
and where the variables come from. docs/USER_GUIDE.md - Tools menu: Condition at the cursor (TcAgent) opens the Inline-Logic-View, Rewrite condition (TcAgent) ... the window.
TcAgent.exe condition --layout: each rewrite as the code that replaces the condition (code, checked again in
codeChecked), the whole truth table inresults;tc_conditionoffers turned comparisons.
Fixed
- Search, documentation, risk and refactoring analysis save everything open in the IDE first (like
tc_save), so code
written withtc_plc_writeis in the files they read; the search result says "saved first". Not in ask/propose mode -
there objects with unsaved changes are read through the IDE. Changes to the code still go only through the IDE. - Documentation, risk analysis (
tc_doc,tc_risk_rules,TcAgent.exe doc) andtc_refactorread the code from the saved
project files as well, the IDE only for objects open with unsaved changes - the risk analysis over a project with 430
objects crashed Visual Studio the same way as the search. The result is the same (checked on the example project). tc_plc_searchno longer crashes Visual Studio in big projects: it searches the saved project files (in seconds instead of
minutes) and asks the IDE only for objects open with unsaved changes; reading every object through the IDE crashed
devenv.exe (C++ exception in KERNELBASE, reproduced twice on a project with 430 objects, feedback FB-4E5119CA).
source=idekeeps the old way.tc_test_run: code in folders starting with_(e.g._this) now counts for "changed since the last
download" - a changed test suite there was run with the old code (feedback FB-6BF3EC9E).TcAgent.exe tcunit list|report|watch --attach [pid]: the solution of the running IDE, no--solutionneeded (FB-D902BE21).- A missing assembly after an update while TcAgent was running (e.g. TwinCAT.Ads on the first ADS call) now says so and
asks to restart the AI client, instead of a bare FileNotFoundException (FB-A0080B14). TcAgent.exe library/tc_library_save: a PLC project without a title says what to fill in (Title, Company, Version in
the project information) instead of only "not a managed library".tc_motion_add kind=nc_taskreturned an empty path and the nextkind=axisfound no Axes folder - the new NC task is
looked up again by its name;tc_motionlists the tasks with their paths.tc_coe action=add: the new entry no longer takes over "CompleteAccess" from the PDO entry it copies its format from
(a single subindex was written as a complete access).tc_refactorworks in a solution with several PLC projects - it finds the project of the object (plcProjectPathoptional);
before it stopped with "Several PLC projects".- Editor context: two objects with the same name (e.g. a method
Exchangein two FBs) no longer both appear as the
open object. tc_task set cores: a warning when a core is not a real-time core - the activation would fail.- TcUnit report showed old test texts after a run without download when only
///comments had changed: a run now
saves what is open in the IDE before it reads the tests (texts and line numbers are current), and the report button
of the window saves before it makes the report. - TcUnit tests of a PLC project kept in its own .xti file are found again (TcUnit Tests window,
tc_test_run,
tcunit list): thePrjFilePathof the .xti is relative to the .xti, not to the .tsproj (the .tsproj folder is still
tried for older projects). A PLC project whose .plcproj is not found is now named with the path tried instead of being
left out silently. - Knowledge > Sources: a commit in a source shows as an update of the installed items it touches. The content of the
item in Git decides (git diffbetween the installed and the source commit), not a version number in its header; a
source in a folder on this computer is read again whenever the state is shown, so the commit shows at once (was: only
after Check for updates, whose result the list did not even show until a refresh). Browse and install … marks
them ↑ update available (or ✎ when you changed the item too), offers them ticked with "Only updates", and
Update … brings them to the new commit where they are installed.sources pulltakes--level. - Chat: Stop no longer ends the Claude Code session - it interrupts the running answer only, an open question
card counts as not answered, and the next question goes on with the whole conversation (was: a new session without
the history). Only if Claude Code has not stopped after 8 s is the session ended as before. - Format ST code and Apply in the condition window: one Ctrl+Z takes it back (was two - select all and paste were two
undo steps, now one compound action of the editor). - Inline-Logic-View: 📌 (pin), ⏸ (freeze) and ⊟ (fold) no longer end Visual Studio - a click ran an empty action.
- A sign in a condition stays at its number (
fSine < -0.5, was< - 0.5). - Condition window: a long nested condition is laid out over several lines with its inner groups further in, also when
cond.linesispreserve(the rewrite had stayed one line of about 200 characters). - Format ST code: when the cursor stands in a section switched off in the code, the status bar says so with the marker
and its line, instead of "already formatted"; anoffwithoutonis named too (format --json:off,offToEnd). - Format ST code: the clipboard is tried again for a second when another program holds it.