Skip to content
Back to search

tlaplus-plugin

MarketplaceWorks with Claude CodeGitHub

Install the TLA+ plugin.

Safety scan

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

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ririnto/tlaplus-plugin with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ririnto/tlaplus-plugin'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ririnto--tlaplus-plugin/badge.svg)](/listings/ririnto--tlaplus-plugin)

HTML

<a href="/listings/ririnto--tlaplus-plugin"><img src="/api/listings/ririnto--tlaplus-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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 · 14 lines
  1. {
  2. "name": "tlaplus-plugin",
  3. "owner": {
  4. "name": "ririnto"
  5. },
  6. "plugins": [
  7. {
  8. "name": "tlaplus-plugin",
  9. "source": "./",
  10. "description": "Parse TLA+ specifications, check models with TLC, and read TLA+ modeling guidance."
  11. }
  12. ],
  13. "description": "Install the TLA+ plugin."
  14. }
README.md · README · 53 lines
  1. # TLA+ plugin
  2. Run SANY and TLC from an MCP client without opening an editor. The npm package includes the stdio server, the official TLA+ tools JAR, GraalVM Community runtimes, three modeling skills, and the TLA+ knowledge base from the VS Code extension.
  3. ## Use the package
  4. Install Node.js 24 or later. Linux x64 and arm64 (glibc), macOS on Apple silicon, and Windows x64 use the bundled runtime. Other platforms can use Java 11 or later on PATH. Install the release tarball in your project, then start the server with `npm exec -- tlaplus-plugin`. After registry publication, the package name is `@ririnto/tlaplus-plugin`.
  5. ```sh
  6. npm install /path/to/ririnto-tlaplus-plugin-2026.11.19+02.tgz
  7. npm exec -- tlaplus-plugin
  8. ```
  9. For a general MCP client, set `command` to `node` and pass the absolute path to `node_modules/@ririnto/tlaplus-plugin/dist/server.mjs` as its only argument. The server communicates over stdio and uses the JAR shipped with the package. Only run trusted specifications and JVM options.
  10. Claude Code, Codex, and Cursor manifests are included. Point your host at the installed package directory or the extracted tarball. For example, from the npm project:
  11. ```sh
  12. claude --plugin-dir ./node_modules/@ririnto/tlaplus-plugin
  13. codex plugin marketplace add ./node_modules/@ririnto/tlaplus-plugin
  14. codex plugin add tlaplus-plugin@tlaplus-plugin
  15. ```
  16. For Cursor, extract the tarball's `package/` contents into `~/.cursor/plugins/local/tlaplus-plugin/` and reload the window. If you use a Git checkout directly, build it first.
  17. ## Tools and references
  18. | MCP tool | Operation |
  19. | --- | --- |
  20. | `tlaplus_mcp_sany_parse` | Parse a module and check its semantics. |
  21. | `tlaplus_mcp_tlc_check` | Exhaustively check a model and its configured properties. |
  22. | `tlaplus_mcp_tlc_smoke` | Run one bounded random simulation. |
  23. | `tlaplus_mcp_tlc_explore` | Return one bounded behavior, including its initial state and ordered variable values. |
  24. Pass an absolute `fileName`. TLC tools also accept an absolute `cfgFile`, plus `extraOpts` and `extraJavaOpts` as arrays of individual arguments. Explore accepts a positive `behaviorLength` and defaults to 100. Requests support cancellation and have a two-minute Java execution limit. Results include process status, diagnostics and truncation information.
  25. The bundled skills cover adding a variable, splitting an action, and deriving a specification from source code. MCP clients can list and read the bundled Markdown articles at `tlaplus://knowledge/<filename>`, for example `tlaplus://knowledge/tlc-config-files.md`.
  26. ## Build a release
  27. Build the universal tarball on Linux x64 with Git, Node.js 24+, npm, curl, jq, GNU tar, and unzip.
  28. ```sh
  29. npm install
  30. npm pack
  31. npm test
  32. ```
  33. The build fetches the default branches of AgentSkills and vscode-tlaplus, downloads the TLA+ 1.7.4 release JAR, and resolves the latest stable GraalVM Community release once per build. GitHub Actions installs its Linux JDK with the official GraalVM setup action. Its `jlink` builds all four runtimes from that release’s platform-specific JDK modules. The tarball includes the upstream licenses and JavaScript dependency notices. Once installed, the tools and knowledge base work offline.
  34. Native plugin manifests use `yyyy.MM.dd.seq`. The npm package uses the SemVer form `yyyy.MM.dd+seq`. npm compares versions without build metadata, so changing only `seq` does not give a second publishable registry version for the same date.
  35. [AgentSkills](https://github.com/tlaplus/AgentSkills) · [VS Code extension](https://github.com/tlaplus/vscode-tlaplus) · [TLA+ tools](https://github.com/tlaplus/tlaplus) · [GraalVM Community](https://github.com/graalvm/graalvm-ce-builds) · [GraalVM setup action](https://github.com/graalvm/setup-graalvm)

Ratings and comments

Sign in to rate this skill.

Sign in

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