Skip to content
Back to search

lampwright

Discover, reversibly disable, enable, and safely remove AI agent skills

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 21 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/ukchucktown/lampwright 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/ukchucktown/lampwright'

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/ukchucktown--lampwright/badge.svg)](/listings/ukchucktown--lampwright)

HTML

<a href="/listings/ukchucktown--lampwright"><img src="/api/listings/ukchucktown--lampwright/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

README.md · README · 237 lines
  1. # Lampwright
  2. **Switch agent Skills off. Keep them installed.**
  3. ![Lampwright lists more than 70 Skills, disables three after a review, shows them in the Disabled view, and enables one again](./.github/assets/lampwright-demo.gif)
  4. If Lampwright saves context for you, a star on GitHub helps other people find
  5. it.
  6. `lampwright` is a cross-platform terminal application that manages AI agent
  7. Skills and Plugins. It discovers installed content, lets you disable and enable
  8. unused Skills, updates Owner-managed content, and safely removes what you no
  9. longer need.
  10. Lampwright's main advantage is reversible availability control. You can keep a
  11. large Skill collection installed and expose only the Skills that you need at
  12. the time. A smaller active set can reduce the Skill metadata that a harness
  13. loads into model context and may lower token use. The actual savings depend on
  14. the harness and how it loads Skills.
  15. ## Reversible Skill control
  16. Disable makes a Skill unavailable but does not delete its identity or content.
  17. Enable makes the Skill available again.
  18. Lampwright prefers the native controls in Codex, Claude Code, and Gemini CLI.
  19. When a standalone or supported Manager-owned Skill has no native control,
  20. Lampwright can move its complete artifact set to non-expiring Disabled Storage.
  21. Enable restores that set to its original paths and never overwrites an occupied
  22. destination.
  23. This model works well for installations with hundreds of Skills. You can keep
  24. specialized Skills available on disk and activate only the set that fits your
  25. current work.
  26. Lampwright does not install Skills or search a registry. It manages the Skills
  27. that an installer such as the Vercel `skills` CLI put in a directory that
  28. Lampwright scans. See
  29. [Lampwright and similar tools](./docs/comparison.md) for a feature matrix.
  30. ## Features
  31. | Feature | What Lampwright does |
  32. | --- | --- |
  33. | Live Inventory | Finds standalone, Manager-owned, and Plugin-owned Skills in Codex, Claude Code, and Gemini CLI, in the shared `.agents/skills` directories that many harnesses read, and in the agent directories of the Vercel `skills` Manager. |
  34. | Reversible disable and enable | Uses native harness controls when possible, or safely suspends complete supported artifact sets in Disabled Storage. |
  35. | Plugin availability | Disables or enables a supported Plugin as one complete boundary while its files stay installed. |
  36. | Owner-managed Update | Asks the current Owner to update an existing target, then rescans and verifies the local result. |
  37. | Safe removal | Uses the Owner's removal operation first. A separately confirmed filesystem fallback moves content to recoverable Quarantine. |
  38. | Built-in protection | Blocks changes to System Skills, non-ignored Git worktree content, read-only paths, and incomplete ownership boundaries. |
  39. | Terminal and automation interfaces | Provides an interactive terminal UI, dry runs, stable JSON, and a non-interactive CLI. |
  40. | Themes | Uses the colors of your terminal by default. You can add custom themes as TOML files, and a theme picker previews each theme on the real screen. |
  41. | Cross-platform support | Runs on macOS, Linux, and Windows with Node.js 20 or newer. |
  42. | Private by design | Adds no telemetry and does not transmit local paths, Inventory data, metadata, or search queries. |
  43. ## Supported harnesses
  44. Lampwright covers a harness at one of three levels. The level depends on the
  45. controls that the harness has and on the directory that holds the Skill.
  46. | Level | Harnesses | What Lampwright can do |
  47. | --- | --- | --- |
  48. | Native controls | Codex, Claude Code, and Gemini CLI | Disable and enable a Skill or a complete Plugin through the configuration of the harness. Lampwright also finds and removes the Plugins of these harnesses, and it updates a Plugin when the Owner has an update operation. |
  49. | Shared directory | Each harness that reads `~/.agents/skills` or `<workspace>/.agents/skills`. The path registry of `skills@1.9.0` lists 22 agents that read the project directory, for example Cursor, GitHub Copilot, OpenCode, and Pi. | Find each Skill, disable it through Disabled Storage, and remove it. |
  50. | Vercel `skills` Manager | The 76 agents in the path registry of `skills@1.9.0`, for example Junie, Windsurf, and Continue | Find a Skill that the Manager owns in the directory of each agent, update it and remove it through the Manager, and disable it through Disabled Storage. |
  51. The Agents column of the Inventory shows the harnesses that can load each
  52. Skill. The name `universal` in that column is the shared `.agents/skills`
  53. directory. Lampwright does not scan the private directory of a harness outside
  54. these three levels unless a local Adapter that you load with `--adapter`
  55. declares the directory as a root. See [Adapter runtime](./docs/adapters.md).
  56. ## How Lampwright compares
  57. | Need | Lampwright | `asm` | `skills` | `skill-cli` |
  58. | --- | --- | --- | --- | --- |
  59. | Install a Skill or search a catalog | No | Yes | Yes | Yes |
  60. | Disable a Skill and keep it installed | Yes, native control or Disabled Storage | Yes, renames `SKILL.md` | No command | Yes, in its own store |
  61. | Disable or enable a complete Plugin | Yes | No | Not described | Not applicable |
  62. | Removal that you can undo | Filesystem removals sent to Quarantine can be restored for 30 days by default. A Managed Removal has no undo. | Not described | Not described | Not described |
  63. | Complete plan before each change | Yes, `--dry-run` | Some commands | Experimental commands | Not described |
  64. | Protection for tracked Git files and System Skills | Yes, for each path that Lampwright or a trusted Owner declares | Not described | Not described | Not applicable |
  65. | Token cost reports and security scans | No | Yes | Partner risk ratings before an installation from a public GitHub source | Not described |
  66. Lampwright fits best when Skills from different tools are already installed
  67. and you want to control them safely and reversibly. An installer fits best
  68. when you need to find and add Skills. You can use both when the installer
  69. puts Skills in a directory that Lampwright scans: install with `skills`, then
  70. manage with Lampwright. The
  71. [complete comparison](./docs/comparison.md) has the full matrix, the sources,
  72. the date of the review, and the features that Lampwright does not have.
  73. ## Run Lampwright
  74. The primary interface is an interactive terminal Inventory. The supported,
  75. version-pinned invocation for the current release is:
  76. ```console
  77. npx lampwright@0.4.2
  78. ```
  79. This command downloads the package to npm's cache. Lampwright does not install
  80. itself globally or add a dependency to the current project.
  81. ![Lampwright Inventory terminal interface](./docs/assets/tui-inventory.png)
  82. The header shows the three views, which are Inventory, Disabled, and Trash, and
  83. the selection status. The row below the header shows the keys that apply in the
  84. current context. Press `?` for the complete key reference and `ctrl+p` for the
  85. theme picker.
  86. ## Themes
  87. The default theme, `terminal`, uses the 16 colors of your terminal, so
  88. Lampwright follows a light or a dark terminal theme. The second built-in theme,
  89. `nightfall`, uses fixed colors for a dark background.
  90. To add a custom theme, put a TOML file in the `themes` directory of the
  91. Lampwright configuration directory. That directory is `~/.config/lampwright`
  92. on macOS and Linux unless `XDG_CONFIG_HOME` is set, and `%APPDATA%\lampwright`
  93. on Windows.
  94. ```toml
  95. # ~/.config/lampwright/themes/ocean.toml
  96. name = "ocean"
  97. extends = "terminal"
  98. [styles]
  99. title = "#3399ff bold"
  100. focus = "white on #484e5b bold"
  101. muted = "dim"
  102. ```
  103. A theme file sets a style for some or all of the 11 roles, and each other role
  104. takes its style from the theme that `extends` names. Press `ctrl+p` to open
  105. the theme picker, which lists the built-in themes and then your custom themes.
  106. The picker shows the real screen with the highlighted theme, and Enter saves
  107. the selection. You can also name a theme with `--theme <name>` or with the
  108. `LAMPWRIGHT_THEME` environment variable. See
  109. [Theme and color](./docs/tui.md#theme-and-color) for the roles, the color
  110. formats, and the rules for a theme file that is not valid.
  111. ## Safety model
  112. Lampwright rebuilds Inventory from live, bounded evidence on every run. It
  113. attributes ownership before it creates a plan. It prefers the Owner's supported
  114. Managed Removal and never silently substitutes a filesystem fallback. A
  115. separately confirmed Brute-force Removal moves artifacts into Quarantine.
  116. Non-ignored Git worktree content and System Skills cannot be mutated, including
  117. with force. Matching names and hashes do not merge Skill identities. Ordinary
  118. remove-all excludes Plugins. Lampwright cannot disable Plugin-owned Skills
  119. individually. When a harness exposes a safe native control, Lampwright can
  120. disable or enable the complete Plugin and keep its files installed.
  121. Read-only scans, TUI browsing, and dry runs create no persistent state. A theme
  122. that you confirm in the theme picker is the one preference that Lampwright
  123. saves. The
  124. application has no telemetry and does not transmit paths, Inventory, metadata,
  125. or search queries.
  126. ## Interfaces
  127. ```console
  128. lampwright # interactive terminal UI
  129. lampwright --theme <name> # interactive terminal UI with one theme
  130. lampwright scan # print the live Inventory
  131. lampwright update <target> # ask the current Owner to update one target
  132. lampwright disable <target> # natively disable or safely suspend targets
  133. lampwright enable <target> # enable native or Disabled Storage targets
  134. lampwright remove <target> # review and remove selected target(s)
  135. lampwright restore <entry> # restore a Quarantine entry
  136. lampwright purge <entry> # permanently delete Quarantine entries
  137. ```
  138. See [Reversible Skill availability](./docs/availability.md) for Native versus
  139. Suspended state, safe recovery, reports, and platform behavior.
  140. See [Targeted Owner Update](./docs/update.md) for Update authority,
  141. verification, and the no-rollback model.
  142. Use `lampwright --help` for selectors, approvals, JSON output, dry-run, and
  143. stable exit statuses. See the [terminal UI](./docs/tui.md) and
  144. [non-interactive CLI](./docs/cli.md) guides for the complete behavior.
  145. See [Theme and color](./docs/tui.md#theme-and-color) for the built-in themes,
  146. the format of a theme file, and the order in which Lampwright selects a theme.
  147. ## Documentation
  148. - [Product specification](./docs/spec.md)
  149. - [Domain language](./CONTEXT.md)
  150. - [Module design](./docs/module-design.md)
  151. - [Core model](./docs/model.md)
  152. - [Reversible Skill availability](./docs/availability.md)
  153. - [Targeted Owner Update](./docs/update.md)
  154. - [Inventory scanning](./docs/inventory.md)
  155. - [Adapter runtime](./docs/adapters.md)
  156. - [Removal planning](./docs/planning.md)
  157. - [Execution and fallback](./docs/execution.md)
  158. - [Lampwright and similar tools](./docs/comparison.md)
  159. - [Terminal UI](./docs/tui.md)
  160. - [Non-interactive CLI](./docs/cli.md)
  161. - [0.4.2 release notes](./docs/releases/0.4.2.md)
  162. - [Release readiness](./docs/release.md)
  163. - [Product ideas](./docs/ideas.md) — unapproved directions under consideration
  164. - [Architectural decisions](./docs/adr/)
  165. - [Contributing](./CONTRIBUTING.md) and [security policy](./SECURITY.md)
  166. ## Development
  167. Node.js 20 or newer is required.
  168. ```console
  169. npm ci
  170. npm run format:check
  171. npm run lint
  172. npm run typecheck
  173. npm test
  174. npm run build
  175. npm run pack:check
  176. ```
  177. After building:
  178. ```console
  179. npx --no-install lampwright
  180. npx --no-install lampwright --help
  181. npx --no-install lampwright --version
  182. ```
  183. CI runs the complete gate and package audit on Node 20, 22, and 24 across
  184. macOS, Linux, and Windows. Release preparation never authorizes npm publication,
  185. a Git tag, or a GitHub release. Follow the manual checklist in
  186. [`docs/release.md`](./docs/release.md).
  187. ## License
  188. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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