Skip to content
Back to search

saltworks

MarketplaceWorks with Claude CodeGitHub

Nine mods for Claude Code, each installed alone: two dithered salt-flat themes, guards for commits, pushes, deletes and read-only folders, a style linter, and two bands above the prompt. Written in TypeScript as function-hook plugins.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 18 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/Stiven-Gjekaj/saltworks 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/Stiven-Gjekaj/saltworks'

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/stiven-gjekaj--saltworks/badge.svg)](/listings/stiven-gjekaj--saltworks)

HTML

<a href="/listings/stiven-gjekaj--saltworks"><img src="/api/listings/stiven-gjekaj--saltworks/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

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

At the prompt of a Claude Code session in a terminal, install each mod that you want by its name:

/plugin install salt-moon --marketplace Stiven-Gjekaj/saltworks

Claude Code asks `Add marketplace?`. Answer `y`, then pick the user scope. The mod runs at once, and in each session after it.

From a shell:

claude plugin install commit-guard --marketplace Stiven-Gjekaj/saltworks

In the desktop app: click **+** next to the prompt box, then **Plugins**, then **Add marketplace** with `Stiven-Gjekaj/saltworks`, then **Add plugin**.

---

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 · 18 lines
  1. {
  2. "name": "saltworks",
  3. "owner": { "name": "Stiven Gjekaj" },
  4. "metadata": {
  5. "description": "Mods for Claude Code: two dithered themes, guards for git and files, and two bands above the prompt. Install each one alone."
  6. },
  7. "plugins": [
  8. { "name": "salt-moon", "source": "./plugins/salt-moon", "description": "A dark theme: a dithered salt flat under a pale moon." },
  9. { "name": "salt-moon-dawn", "source": "./plugins/salt-moon-dawn", "description": "A light theme: the same salt flat at dawn, under a low sun." },
  10. { "name": "commit-guard", "source": "./plugins/commit-guard", "description": "Blocks a commit or a pull request text that breaks a rule that you turn on." },
  11. { "name": "push-guard", "source": "./plugins/push-guard", "description": "Asks you before Claude pushes, opens a pull request, or makes a release." },
  12. { "name": "readonly-guard", "source": "./plugins/readonly-guard", "description": "Keeps folders that you name read only." },
  13. { "name": "delete-guard", "source": "./plugins/delete-guard", "description": "Blocks a recursive delete of a folder that Claude did not list first." },
  14. { "name": "style-linter", "source": "./plugins/style-linter", "description": "Blocks em-dashes and emoji in files, and notes passive voice in prose." },
  15. { "name": "commit-size-band", "source": "./plugins/commit-size-band", "description": "Shows the staged size above the prompt, amber when a commit is too big." },
  16. { "name": "sessions-band", "source": "./plugins/sessions-band", "description": "Shows linked sessions and active subagents above the prompt." }
  17. ]
  18. }
README.md · README · 243 lines
  1. <div align="center">
  2. ![Saltworks](assets/wordmark.svg)
  3. ### Mods for Claude Code: two themes, four guards, a linter and two bands
  4. _Each mod is its own plugin. Install the ones you want, and leave the rest._
  5. ![TypeScript](https://img.shields.io/badge/typescript-9fb4ec?style=for-the-badge&logo=typescript&logoColor=10121c)
  6. ![Claude Code](https://img.shields.io/badge/claude_code_2.1.325+-b9a6e6?style=for-the-badge&logoColor=10121c)
  7. ![Nine mods](https://img.shields.io/badge/9_mods-e9a8b8?style=for-the-badge&logoColor=10121c)
  8. [![MIT licence](https://img.shields.io/badge/mit_licence-f3b48a?style=for-the-badge&logoColor=10121c)](LICENSE)
  9. <p align="center">
  10. <a href="#overview"><b>Overview</b></a> |
  11. <a href="#the-themes"><b>Themes</b></a> |
  12. <a href="#the-mods"><b>Mods</b></a> |
  13. <a href="#install"><b>Install</b></a> |
  14. <a href="#settings"><b>Settings</b></a> |
  15. <a href="#develop"><b>Develop</b></a>
  16. </p>
  17. </div>
  18. ---
  19. > [!NOTE]
  20. > **Each mod is separate.**
  21. > A mod is a plugin of function hooks for Claude Code. It needs Claude Code
  22. > 2.1.325 or newer.
  23. > The themes draw in the Claude desktop app and the mobile app. The terminal
  24. > draws no theme.
  25. > The guards and the bands work in each place that Claude Code runs.
  26. ---
  27. ## Overview
  28. **Saltworks** is a set of nine mods for Claude Code.
  29. A mod changes what Claude Code shows, or what Claude can do.
  30. Some mods change the look. Two themes paint a dithered salt flat behind the
  31. conversation, one by night and one at dawn.
  32. Some mods stop a mistake before it happens. A guard reads each tool call before
  33. it runs, and refuses or asks when the call breaks a rule.
  34. Some mods show a state. A band is a row above the prompt. It stays hidden when
  35. it has nothing to say.
  36. <table>
  37. <tr>
  38. <td width="50%" valign="top">
  39. ### What the mods do
  40. - **Paint a theme** with an animated scene and a full palette.
  41. - **Guard a commit** against attribution lines, em-dashes, emoji and the
  42. wrong git identity.
  43. - **Ask before a push**, a pull request or a release.
  44. - **Keep a folder read only**, and **look before a delete**.
  45. - **Show the size of a commit** and **the work in progress** above the prompt.
  46. </td>
  47. <td width="50%" valign="top">
  48. ### How they behave
  49. - One mod does one job, and you install each one alone.
  50. - Each rule that a person can disagree with is a setting.
  51. - A guard tells Claude what to do instead, in one sentence.
  52. - A band takes no row when it has nothing to show.
  53. - Each guard and each band has tests.
  54. </td>
  55. </tr>
  56. </table>
  57. ---
  58. ## The themes
  59. <table>
  60. <tr>
  61. <td width="50%" valign="top">
  62. ### Salt Moon
  63. A dark theme. Indigo sky, dark mesas with a lit rim, a crescent moon and its
  64. reflection on the salt. The stars twinkle and the clouds drift, in whole dither
  65. cells.
  66. </td>
  67. <td width="50%" valign="top">
  68. ### Salt Moon Dawn
  69. A light theme. The same salt flat at first light: lilac sky, a peach glow on
  70. the horizon, dusk-purple mesas and a low sun.
  71. </td>
  72. </tr>
  73. </table>
  74. ![Salt Moon](assets/screenshots/salt-moon.png)
  75. ![Salt Moon Dawn](assets/screenshots/salt-moon-dawn.png)
  76. > [!TIP]
  77. > These images are previews. `scripts/previews/render.mjs` draws each scene with
  78. > the colors of its theme, behind a frosted column like the conversation.
  79. > The app draws its own layout over the same scene.
  80. A theme sets the whole look of the app, so install one theme at a time.
  81. If both are on, the theme that starts last wins.
  82. ---
  83. ## The mods
  84. | Mod | Kind | What it does |
  85. | --- | --- | --- |
  86. | [`salt-moon`](plugins/salt-moon) | Theme | A dark dithered salt flat under a pale moon. |
  87. | [`salt-moon-dawn`](plugins/salt-moon-dawn) | Theme | The same salt flat at dawn, under a low sun. |
  88. | [`commit-guard`](plugins/commit-guard) | Guard | Blocks a commit or a pull request text with an attribution line, an em-dash, an emoji, a version in the subject, or the wrong git identity. |
  89. | [`push-guard`](plugins/push-guard) | Guard | Asks you before Claude runs `git push`, opens or merges a pull request, or makes a release or a repository. |
  90. | [`readonly-guard`](plugins/readonly-guard) | Guard | Keeps folders that you name read only. Claude can still copy a file out of them. |
  91. | [`delete-guard`](plugins/delete-guard) | Guard | Blocks `rm -r` on a folder until Claude lists that folder in the session. |
  92. | [`style-linter`](plugins/style-linter) | Linter | Blocks an em-dash or an emoji that Claude adds to a file, and notes passive voice in prose. |
  93. | [`commit-size-band`](plugins/commit-size-band) | Band | Shows the staged files and lines, and turns amber when one commit grows too big. |
  94. | [`sessions-band`](plugins/sessions-band) | Band | Shows the sessions linked to this one and the subagents that run. |
  95. Each mod has a README in its folder with its settings and its limits.
  96. ---
  97. ## Install
  98. At the prompt of a Claude Code session in a terminal, install each mod that you
  99. want by its name:
  100. ```
  101. /plugin install salt-moon --marketplace Stiven-Gjekaj/saltworks
  102. ```
  103. Claude Code asks `Add marketplace?`. Answer `y`, then pick the user scope.
  104. The mod runs at once, and in each session after it.
  105. From a shell:
  106. ```bash
  107. claude plugin install commit-guard --marketplace Stiven-Gjekaj/saltworks
  108. ```
  109. In the desktop app: click **+** next to the prompt box, then **Plugins**, then
  110. **Add marketplace** with `Stiven-Gjekaj/saltworks`, then **Add plugin**.
  111. ---
  112. ## Settings
  113. A guard rule that a person can disagree with is a setting, and you can turn it
  114. off. Open `/config` in Claude Code and find the mod by name.
  115. You can also write the settings in `~/.claude/settings.json`:
  116. ```json
  117. {
  118. "pluginConfigs": {
  119. "commit-guard": {
  120. "options": {
  121. "gitName": "Ada Lovelace",
  122. "gitEmail": "ada@example.com",
  123. "conventional": true
  124. }
  125. },
  126. "readonly-guard": {
  127. "options": { "folders": "Materials, ~/vault" }
  128. }
  129. }
  130. }
  131. ```
  132. | Mod | Setting | Default |
  133. | --- | --- | --- |
  134. | `commit-guard` | `gitName`, `gitEmail` | empty, so no identity check |
  135. | `commit-guard` | `attribution`, `emDash`, `emoji`, `versionInSubject`, `prText` | on |
  136. | `commit-guard` | `conventional` | off |
  137. | `push-guard` | `mode`: `ask` or `deny` | `ask` |
  138. | `readonly-guard` | `folders`, a comma-separated list | `Materials` |
  139. | `style-linter` | `emDash`, `emoji`, `passive` | on |
  140. | `commit-size-band` | `maxFiles`, `maxLines` | `5`, `300` |
  141. ---
  142. ## Develop
  143. Load a mod from its folder, so that each save reloads it:
  144. ```bash
  145. claude --plugin-dir plugins/commit-guard
  146. ```
  147. Run the gate before you send a change. It validates each mod and runs its tests:
  148. ```bash
  149. scripts/check.sh
  150. ```
  151. Draw the theme previews again after you change a theme:
  152. ```bash
  153. node --experimental-strip-types scripts/previews/render.mjs
  154. ```
  155. [CONTRIBUTING.md](CONTRIBUTING.md) says how to add a mod, and
  156. [AGENTS.md](AGENTS.md) holds the rules for every change.
  157. | File | What it holds |
  158. | --- | --- |
  159. | [CONTRIBUTING.md](CONTRIBUTING.md) | How to add or change a mod |
  160. | [AGENTS.md](AGENTS.md) | The rules for a change, human or agent |
  161. | [CHANGELOG.md](CHANGELOG.md) | Each release, newest first |
  162. | [SECURITY.md](SECURITY.md) | How to report a security problem |
  163. | [SUPPORT.md](SUPPORT.md) | Where to ask a question |
  164. | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Applies to everybody who takes part |
  165. ---
  166. ## Licence
  167. MIT. See [LICENSE](LICENSE) and [TERMS.md](TERMS.md).
  168. `make-colors.js` in each theme comes from the plugin kit of Claude Code. The kit
  169. tells a mod to copy that file and keep it as it is, so this project does not
  170. change it, and the MIT licence of this project does not cover it.
  171. Saltworks is not a product of Anthropic. Claude and Claude Code are names of
  172. Anthropic, and this project uses them only to say what the mods are for.
  173. <div align="center">
  174. <sub>A guard is a second check, not the only one. Read what Claude asks to run.</sub>
  175. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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