Skip to content
Back to search

reveal-paths

MarketplaceWorks with Claude CodeGitHub

Claude desktop app mod (Windows): click a file path to show it in File Explorer; right-click a .cmd for run options

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/codezoozoo--reveal-paths/badge.svg)](/listings/codezoozoo--reveal-paths)

HTML

<a href="/listings/codezoozoo--reveal-paths"><img src="/api/listings/codezoozoo--reveal-paths/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.

Needs Windows and the Claude desktop app (Code tab). The PowerShell and Claude CLI options also need PowerShell 7 (`pwsh`) and Windows Terminal.

At the prompt of a Claude Code terminal session:

/plugin install reveal-paths --marketplace CodeZooZoo/reveal-paths

Answer `y` to add the marketplace, then pick the user scope. From a shell:

claude plugin install reveal-paths --marketplace CodeZooZoo/reveal-paths

In the desktop app, where `/plugin` doesn't run: click **+** next to the prompt box, then **Plugins**, **Add marketplace** with `CodeZooZoo/reveal-paths`, then **Add plugin**. It works in new desktop sessions.

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": "reveal-paths",
  3. "owner": { "name": "CodeZooZoo", "url": "https://github.com/CodeZooZoo" },
  4. "metadata": { "description": "Claude desktop app mod: click a file path to show it in File Explorer; right-click a .cmd for run options" },
  5. "plugins": [
  6. {
  7. "name": "reveal-paths",
  8. "source": "./",
  9. "description": "Claude desktop app (Windows): click a file path in a reply and File Explorer opens with it selected; right-click a .cmd/.bat for Run, Run as admin, PowerShell, Claude's terminal or Claude CLI.",
  10. "version": "0.2.0",
  11. "author": { "name": "CodeZooZoo", "url": "https://github.com/CodeZooZoo" },
  12. "homepage": "https://github.com/CodeZooZoo/reveal-paths",
  13. "license": "MIT",
  14. "category": "productivity",
  15. "tags": ["mod", "paths", "explorer", "windows", "desktop"]
  16. }
  17. ]
  18. }
README.md · README · 85 lines
  1. <p align="center"><img src=".claude-plugin/icon.png" width="96" alt="reveal-paths icon"></p>
  2. # reveal-paths
  3. **A Claude Code mod for the Claude desktop app on Windows: click a file path in a reply and File Explorer opens with that file selected. Right-click a `.cmd` or `.bat` for a run menu.**
  4. Claude writes `C:\Users\me\notes.txt`, a backticked relative path, or a markdown link like `[pc.md](reference/pc.md)`. With reveal-paths, every one of those that exists on disk becomes a link. Click it and Explorer opens with the file highlighted. Right-click it there for Windows' own menu: Open with, Copy as path, Properties and the rest.
  5. When a reply names a `.cmd` or `.bat` file, a line appears under it:
  6. ```text
  7. ⚙ build.cmd · right-click for run options
  8. ```
  9. Right-click it for:
  10. | Option | What it does |
  11. |---|---|
  12. | **Run** | Runs it in a Command Prompt window that stays open |
  13. | **Run as admin** | Windows asks first (UAC), then runs it elevated |
  14. | **Run in PowerShell** | Runs it in a PowerShell 7 window that stays open |
  15. | **Run in Claude's terminal** | Puts the request in the prompt box; press Enter and Claude runs it in the Terminal panel |
  16. | **Open Claude CLI here** | Opens Windows Terminal in the file's folder with `claude` running |
  17. ## Install
  18. Needs Windows and the Claude desktop app (Code tab). The PowerShell and Claude CLI options also need PowerShell 7 (`pwsh`) and Windows Terminal.
  19. At the prompt of a Claude Code terminal session:
  20. ```text
  21. /plugin install reveal-paths --marketplace CodeZooZoo/reveal-paths
  22. ```
  23. Answer `y` to add the marketplace, then pick the user scope. From a shell:
  24. ```bash
  25. claude plugin install reveal-paths --marketplace CodeZooZoo/reveal-paths
  26. ```
  27. In the desktop app, where `/plugin` doesn't run: click **+** next to the prompt box, then **Plugins**, **Add marketplace** with `CodeZooZoo/reveal-paths`, then **Add plugin**. It works in new desktop sessions.
  28. ## Safety
  29. Claude's replies can be steered by text it reads, so every path in a reply is treated as untrusted:
  30. - **A plain click never opens or runs anything.** It only shows the file in Explorer.
  31. - **Running needs two deliberate clicks** (right-click, then an option), and only for a `.cmd` or `.bat` file that exists, checked again at the moment you click. "Run as admin" also goes through Windows' own UAC prompt.
  32. - **No injection.** The file's path reaches PowerShell only through an environment variable, never inside the command text. Names holding characters `cmd.exe`, Explorer or Windows Terminal would re-read (`& | < > ^ % ! " , ;`) are refused.
  33. - **No network paths.** `\\server\share` paths are never linked: opening one can send your Windows credentials to that host.
  34. - **Sends nothing.** The mod makes no network calls and reads no environment variables, credentials or file contents.
  35. ## What it reads, runs and sends
  36. **Hooks** (`hooks/register.tsx`):
  37. | Hook | What it does |
  38. |---|---|
  39. | `ui.render` on `AssistantMessage` (desktop surface only) | Finds paths in a reply, checks they exist with `$.fs.stat`, and redraws the reply as a `Markdown` whose links the mod answers (`onLinkPress`). The stored conversation is not changed. Adds a `Client` region per `.cmd`/`.bat` file. |
  40. | `ui.message` | Receives the option picked in a `.cmd` menu, re-checks the file, and runs it. |
  41. The `.cmd` menu is a `Client` surface module (`hooks/cmd-menu.tsx`) that opens on a right-click via `surface.onPointer` and posts the choice back with `surface.post`.
  42. **Runs** (`$.process.run`, by argument vector, no shell), only on your click:
  43. | Program | When |
  44. |---|---|
  45. | `powershell.exe -Command Start-Process explorer.exe /select,<file>` | a click on a path (PowerShell asks for a visible window; a direct `explorer.exe` call from Claude opens hidden) |
  46. | `powershell.exe -Command Start-Process cmd.exe /k <file>` | Run, and Run as admin (`-Verb RunAs`) |
  47. | `powershell.exe -Command Start-Process pwsh.exe -NoExit -Command & <file>` | Run in PowerShell |
  48. | `powershell.exe -Command Start-Process wt.exe -d <folder> pwsh -NoExit -Command claude` | Open Claude CLI here |
  49. "Run in Claude's terminal" runs nothing itself: it fills the prompt box (`$.prompt.fill`) and you decide whether to send it.
  50. **Reads:** file metadata only (does the path exist, is it a file or folder, where a link leads) and the session's working directory. **Stores:** nothing.
  51. In the terminal the mod does nothing; for terminal sessions see [open-paths](https://github.com/kiankhooban/open-paths).
  52. ## Credits
  53. Path finding (`hooks/paths.ts`) is copied unchanged from [open-paths](https://github.com/kiankhooban/open-paths) v0.2.0 by Kian Khooban, MIT License.
  54. ## License
  55. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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