Skip to content
Back to search

totally-integrated-claude

A Claude Code plugin for Siemens TIA Portal engineering automation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/czarnak--totally-integrated-claude/badge.svg)](/listings/czarnak--totally-integrated-claude)

HTML

<a href="/listings/czarnak--totally-integrated-claude"><img src="/api/listings/czarnak--totally-integrated-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install from GitHub or clone this repository and link it locally while developing.

Claude Code

/plugin marketplace add Czarnak/totally-integrated-claude

Codex

Install the marketplace from GitHub:

codex plugin marketplace add Czarnak/totally-integrated-claude

From inside an interactive Codex session, you can use the slash-command form:

/plugin marketplace add Czarnak/totally-integrated-claude

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "totally-integrated-claude",
  3. "description": "Siemens TIA Portal engineering automation for Claude Code. Provides routed skills for Python TIA Scripting, C# Openness API, and Modular Application Creator / Module Builder workflows, plus MCP server for TIA Portal V21.",
  4. "owner": {
  5. "name": "Łukasz Rafał Czarnacki",
  6. "email": "czarnacki.lukasz.rafal@gmail.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "totally-integrated-claude",
  11. "source": "./",
  12. "description": "Plugin for TIA Portal, TIA Openness API, and Siemens Modular Application Creator workflows"
  13. }
  14. ]
  15. }
README.md · README · 241 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # totally-integrated-claude
  2. An agent plugin for **Siemens TIA Portal engineering automation**, compatible with Claude Code, Codex, and GitHub Copilot in VS Code and Copilot CLI.
  3. Provides a routed skill framework for TIA Portal engineering automation: Siemens TIA Scripting Python V1.4.3 for its supported wrapper surface, audited C# Openness skills for advanced object-model work, and a dedicated Modular Application Creator path.
  4. ![image](img/repo_graphic.png)
  5. ---
  6. ## Features
  7. - **Scoped automation routing** - `tia-openness-roadmap` honors an explicit implementation choice, then selects Python, C#, MAC Module Builder, diagnostic, or Add-In skills
  8. - **Python TIA Scripting V1.4.3** - Siemens wrapper coverage for PLC data, generic HMI access, devices, libraries, and project workflows via `tia-python`
  9. - **C# Openness** - eleven domain skills covering the V21 Openness domain assemblies (see table below)
  10. - **Modular Application Creator** - `tia-mac-module-builder` covers the audited MAC V21.0.5 lifecycle, generated/custom ownership, resources, packaging, and qualification boundaries
  11. - **TIA Portal Add-In development** — VS Code–based Add-In authoring workflow
  12. - **Environment diagnostics** - `tia-doctor` verifies the exact V21 executable, modular Openness core, and user group, with an optional Python check
  13. - **Certified V21 API baselines** - hosted CI validates committed installed-API evidence without requiring TIA Portal on the runner
  14. ---
  15. ## Skills
  16. | Skill | Purpose |
  17. | --- | --- |
  18. | `tia-openness-roadmap` | **Automation entry point.** Honors explicit scope/path constraints and routes engineering tasks. Pure exported-code review uses `plc-code-analysis` directly. |
  19. | `tia-doctor` | **Manual diagnostic.** Read-only V21 executable/modular API/group probe, with an optional Python check. |
  20. | `plc-code-analysis` | **Standalone.** Evidence-gated PLC security/quality analysis for raw SCL/ST, V21 SIMATIC SD, or schema-valid SimaticML. |
  21. | `tia-python` | Siemens TIA Scripting Python V1.4.3: wrapper-level PLC, HMI, device, library, project, CAx, CFC, project-text, master-copy, and Test Suite workflows. |
  22. | `tia-csharp-common` | C# foundation: TIA Portal process attach, `ExclusiveAccess`, `Transaction`, disposable patterns. Required first load for every C# task. |
  23. | `tia-project-general` | C# project, portal, and library lifecycle: open/create/save/archive/retrieve, project/global libraries, master copies, type/version workflows, UMAC/UMC, language settings, diagnostics. |
  24. | `tia-devices-general` | C# device & device-item operations: hardware catalog, device creation/deletion, slot/subslot traversal, software containers, network connections, hardware parameters. |
  25. | `tia-plc-operations` | C# PLC software engineering: program/system blocks, PLC tags/UDTs, software units, Safety, alarms, OPC-UA, technological objects, watch/force tables, online/download, compare. |
  26. | `tia-hmi-operations` | C# HMI Classic and Unified: separate object models for targets/software, screens/items, tags, alarms, scripts, connections, logging, runtime settings, and compile/import/export. |
  27. | `tia-networks` | C# topology: subnets, nodes, IO systems, port channels, addresses, IO timing. |
  28. | `tia-simatic-drives` | C# Startdrive / SINAMICS: drive controller access, drive engineering, motion control, download. |
  29. | `tia-import-export` | C# & Python import/export: SimaticML, AML/CAx, PLC blocks, HMI screens/tags/alarms, hardware AML, project data. |
  30. | `tia-multiuser` | C# Multiuser Engineering: project-server connections, server-project identity, local/exclusive sessions, marking, locking, save/discard/commit. |
  31. | `tia-teamcenter` | C# provider-based Teamcenter Gateway: connection, search/download, dataset locking, and project/global-library save workflows. |
  32. | `tia-testsuite` | C# TestSuite & Application Test: test sets, application tests, style-guide rules, automated system testing. |
  33. | `tia-sivarc` | C# SiVArc: rule tables and libraries, definitions, expression resolution, layout exchange, and guarded visualization generation. |
  34. | `tia-mac-module-builder` | Modular Application Creator and Module Builder: `TiaEquipmentModule` lifecycle, models/use cases, `.tiares`, generated/custom ownership, packaging, and qualification. |
  35. | `addin-operations` | TIA Portal Add-In development: project structure, VS Code workflow, Add-In lifecycle, menus, permissions, deployment. |
  36. ---
  37. ## Prerequisites
  38. ### Bundled MCP server
  39. The plugin registers [Siemens Docs MCP](https://github.com/Czarnak/siemens-docs-mcp) (`siemens-docs`) for live search and reading of `docs.tia.siemens.cloud`. It starts via `uvx siemens-docs-mcp`, so [uv](https://docs.astral.sh/uv/) must be on `PATH` (it fetches Python 3.11+ as needed).
  40. ### For Python TIA Scripting
  41. - TIA Scripting Python V1.4.3 downloaded from Siemens Industry Online Support
  42. - Python 3.12.x, 3.13.x, or 3.14.x with the matching Windows x64 wheel
  43. - TIA Portal and Openness V15.1 or later according to the V1.4.3 manual; Siemens package metadata separately lists V18-V21, so verify the exact installed target
  44. ### For C# Openness
  45. - Siemens TIA Portal V21 for these audited API references
  46. - V21 modular Openness API, including `Siemens.Engineering.Base.dll` under `PublicAPI\V21\net48`
  47. - .NET Framework 4.8 or later
  48. ### For Modular Application Creator
  49. - Siemens Modular Application Creator and Module Builder matching the target project; the audited skill baseline is MAC V21.0.5
  50. - TIA Portal V21 and its matching Openness PublicAPI for the audited baseline
  51. - .NET Framework 4.8 and access to the project's approved MAC/Module Builder package source
  52. ### For Add-In development
  53. - Visual Studio 2022 or VS Code with C# Dev Kit
  54. - TIA Portal Add-In SDK (available from Siemens Industry Online Support)
  55. TIA Scripting Python is not installed from PyPI by package name. Download the
  56. TIA Scripting Python ZIP from Siemens, then use one of Siemens' supported setup
  57. paths:
  58. - File import: unzip it and set `TIA_SCRIPTING` to the directory containing
  59. `siemens_tia_scripting.pyd` and the supplied adapter DLLs.
  60. - Wheel install: from the extracted package's `install` directory, install the
  61. V1.4.3 wheel whose CPython tag matches the interpreter, for example:
  62. ```powershell
  63. cd C:\Path\To\Your\TIA_Scripting_Python\install
  64. py -3.12 -m pip install .\siemens_tia_scripting-1.4.3-cp312-cp312-win_amd64.whl
  65. ```
  66. To check a local machine, run the bundled doctor probe:
  67. ```powershell
  68. powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21
  69. ```
  70. For machine-readable output:
  71. ```powershell
  72. powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21 -Json
  73. ```
  74. For a C#-only V21 check while Python is intentionally out of scope:
  75. ```powershell
  76. powershell.exe -NoProfile -ExecutionPolicy Bypass -File skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21 -SkipPython
  77. ```
  78. ---
  79. ## Installation
  80. Install from GitHub or clone this repository and link it locally while developing.
  81. ### Claude Code
  82. ```bash
  83. /plugin marketplace add Czarnak/totally-integrated-claude
  84. ```
  85. ### Codex
  86. Install the marketplace from GitHub:
  87. ```bash
  88. codex plugin marketplace add Czarnak/totally-integrated-claude
  89. ```
  90. From inside an interactive Codex session, you can use the slash-command form:
  91. ```bash
  92. /plugin marketplace add Czarnak/totally-integrated-claude
  93. ```
  94. ### VS Code And GitHub Copilot
  95. 1. Enable agent plugins in VS Code with `chat.plugins.enabled` set to `true`.
  96. 2. Run **Chat: Install Plugin From Source** from the Command Palette.
  97. 3. Enter `https://github.com/Czarnak/totally-integrated-claude` and review the trust prompt before installing.
  98. 4. Check **Chat: Configure Skills** for `tia-openness-roadmap` and **MCP: List Servers** for `siemens-docs`.
  99. For a local checkout, add its absolute path to your VS Code user settings instead
  100. of installing the remote copy. For example, if cloned to `C:\src\totally-integrated-claude`:
  101. ```json
  102. {
  103. "chat.plugins.enabled": true,
  104. "chat.pluginLocations": {
  105. "C:/src/totally-integrated-claude": true
  106. }
  107. }
  108. ```
  109. Alternatively, add `Czarnak/totally-integrated-claude` to
  110. `chat.plugins.marketplaces`, then find and install the plugin in the Extensions
  111. view with the `@agentPlugins` filter. The existing Claude marketplace is also
  112. recognized by VS Code and Copilot CLI.
  113. ### GitHub Copilot CLI
  114. ```bash
  115. copilot plugin install Czarnak/totally-integrated-claude
  116. ```
  117. To install a local checkout, run `copilot plugin install .` from its root.
  118. VS Code also discovers plugins installed by Copilot CLI.
  119. The root `plugin.json` and `mcp.json` use the
  120. [Agent Plugins 1.0 format](https://code.visualstudio.com/docs/agent-customization/agent-plugins).
  121. All clients share the same `skills/` content. Claude Code and Codex retain their
  122. client-specific manifests and `.mcp.json`; no skills need to be copied. The plugin
  123. bundles the Siemens documentation server, not a live TIA Portal connection.
  124. ---
  125. ## Usage
  126. Start TIA Portal automation tasks by asking your agent to load `tia-openness-roadmap`.
  127. For review of supplied or exported PLC code, use `plc-code-analysis` directly.
  128. ```text
  129. How do I read all PLC tag tables from an open TIA Portal project?
  130. ```
  131. The agent will load `tia-openness-roadmap`, select the correct implementation path (Python, C#, MAC Module Builder, diagnostic, or Add-In), and load the matching focused skill automatically.
  132. ### Environment diagnostics
  133. Use `tia-doctor` when TIA Portal automation fails because of missing local
  134. prerequisites. It is a read-only PowerShell probe that checks the exact V21 Portal
  135. executable, `Siemens.Engineering.Base.dll` and installed modular API metadata, and
  136. membership in the `Siemens TIA Openness` Windows user group. The Python TIA
  137. Scripting check is optional and can be skipped with `-SkipPython`.
  138. ### Routing examples
  139. | Task | Path | Domain skill |
  140. | --- | --- | --- |
  141. | Analyze raw SCL/ST, SIMATIC SD, or SimaticML for security issues | Standalone | `plc-code-analysis` |
  142. | Read/write PLC blocks and tags | Python | `tia-python` |
  143. | HMI screen access and export | Python | `tia-python` |
  144. | Device slot/subslot manipulation | C# | `tia-devices-general` |
  145. | Subnet and IO-system configuration | C# | `tia-networks` |
  146. | SINAMICS drive engineering | C# | `tia-simatic-drives` |
  147. | Advanced PLC online/security services | C# | `tia-plc-operations` |
  148. | Multiuser Engineering (server projects) | C# | `tia-multiuser` |
  149. | Teamcenter managed projects | C# | `tia-teamcenter` |
  150. | Automated PLC/HMI testing | C# | `tia-testsuite` |
  151. | SiVArc rules or visualization generation | C# | `tia-sivarc` |
  152. | Modular Application Creator module or `.tiares` work | MAC Module Builder | `tia-mac-module-builder` |
  153. | TIA Portal Add-In project | C# | `addin-operations` |
  154. ---
  155. ## Worth installing to boost your workflow
  156. - C# LSP plugin from [Claude Plugins Official](https://github.com/anthropics/claude-plugins-official)
  157. - [Tia Portal MCP Server](https://github.com/Czarnak/tia-portal-mcp)
  158. ## Contributing
  159. See [CONTRIBUTING.md](CONTRIBUTING.md) for contributor setup, validation
  160. commands, test expectations, skill authoring rules, and safety requirements.
  161. Maintainers certifying a new Openness API surface should also follow the
  162. [V21 API baseline workflow](api-baselines/README.md).
  163. ## Sources
  164. - [TIA Portal Openness docs](https://docs.tia.siemens.cloud/r/en-us/v21/tia-portal-openness-api-for-automation-of-engineering-workflows/)
  165. - [TIA Scripting Python](https://support.industry.siemens.com/cs/document/109742322/tool-for-easier-use-of-the-tia-portal-openness-interface-(tia-scripting-python))
  166. ## Examples
  167. - [PLC Block Scanner](https://github.com/Czarnak/plc-block-scanner) - as simple as possible, strictly as an example.
  168. - [TIA Git Add-In](https://github.com/Czarnak/tia-git-addin) - Add-In for TIA Portal V21 making version control comfortable for PLC engineers.
  169. ## License
  170. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.