Skip to content
Back to search

snip

The visual communication layer between humans and AI agents. Capture, annotate, render diagrams, and organize with AI — powered by Electron and Ollama. macOS & Linux.

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

HTML

<a href="/listings/rixinhahaha--snip"><img src="/api/listings/rixinhahaha--snip/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.

macOS (Homebrew)

brew install --cask rixinhahaha/snip/snip

Or download the DMG from [Releases](https://github.com/rixinhahaha/snip/releases) (Apple Silicon).

Linux

Download from [Releases](https://github.com/rixinhahaha/snip/releases): - **AppImage** (portable, any distro) — `Snip-x.y.z-x86_64.AppImage` - **deb** (Ubuntu/Debian) — `Snip-x.y.z-amd64.deb`

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 · 166 lines

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

  1. <p align="center">
  2. <img src="assets/icon.png" alt="Snip" width="128" height="128"><br><br>
  3. <a href="https://www.producthunt.com/products/snip-ai-powered-macos-screenshot-tool?utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-snip-ai-powered-macos-screenshot-tool-2" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1089620&theme=dark" alt="Snip on Product Hunt" height="40"></a>
  4. </p>
  5. # Snip
  6. **Visual mode for Claude Code.** Also works with Cursor, Windsurf, Cline, and any AI coding CLI.
  7. Install Snip, run `snip setup`, and your AI coding agent starts rendering diagrams and previews instead of describing them in text. Architecture? Sequence diagram. Data model? ER diagram. UI component? Rendered preview. All visual, all automatic.
  8. You review what Claude renders — approve it, or annotate directly on screen. Circle what's wrong, add an arrow, write a note. Claude sees your annotations and iterates.
  9. <p align="center">
  10. <img src="assets/demo.gif" alt="Snip demo — agent renders a diagram, user reviews and approves" width="720">
  11. </p>
  12. ## How It Works
  13. Snip runs as a menu bar / system tray app with a CLI that any AI coding agent can call directly:
  14. ```bash
  15. # Claude writes a Mermaid diagram to a file, then renders it for your review
  16. snip render --format mermaid < architecture.mmd
  17. # Claude renders an HTML component preview
  18. snip render --format html < preview.html
  19. # Open any image for annotated review
  20. snip open screenshot.png --message "Is the layout correct?"
  21. # Search your screenshot library
  22. snip search "login page error"
  23. ```
  24. The agent gets structured JSON back: `{ status: "approved" | "changes_requested", edited, path, text }`. You can annotate spatially, type text feedback, or just approve.
  25. Built for **Claude Code**. Also works with Cursor, Windsurf, Cline, and anything that can run a shell command. Ships an [MCP server](#mcp-server) for agents without shell access.
  26. ## Install
  27. ### macOS (Homebrew)
  28. ```bash
  29. brew install --cask rixinhahaha/snip/snip
  30. ```
  31. Or download the DMG from [Releases](https://github.com/rixinhahaha/snip/releases) (Apple Silicon).
  32. ### Linux
  33. Download from [Releases](https://github.com/rixinhahaha/snip/releases):
  34. - **AppImage** (portable, any distro) — `Snip-x.y.z-x86_64.AppImage`
  35. - **deb** (Ubuntu/Debian) — `Snip-x.y.z-amd64.deb`
  36. ## Use with Claude Code
  37. ```bash
  38. snip setup
  39. ```
  40. That's it. `snip setup` configures Claude Code to use visual output automatically — rules, the `/diagram` skill, and permissions. Next time you ask Claude about architecture, data models, or flows, it renders a diagram instead of describing it in text.
  41. Try `/diagram` in any Claude Code conversation to visualize what you're discussing.
  42. ## CLI Reference
  43. | Command | What it does |
  44. |---------|-------------|
  45. | `snip setup` | Enable visual mode for Claude Code (and Cursor, Windsurf, Cline) |
  46. | `snip render --format mermaid` | Render Mermaid diagram from stdin, open for review |
  47. | `snip render --format html` | Render HTML from stdin, open for review |
  48. | `snip open <path>` | Open any image for annotated review |
  49. | `snip search <query>` | Search screenshot library by description |
  50. | `snip transcribe <path>` | Extract text from an image via OCR |
  51. | `snip list` | List all saved screenshots with metadata |
  52. | `snip get <path>` | Get metadata for a specific screenshot |
  53. | `snip organize <path>` | Queue screenshot for AI categorization |
  54. | `snip categories` | List all categories |
  55. All review commands (`render`, `open`) block until the user finishes and return structured JSON.
  56. ## MCP Server
  57. For agents without shell access (Claude Desktop, hosted environments), Snip also ships an MCP server:
  58. ```json
  59. {
  60. "mcpServers": {
  61. "snip": {
  62. "command": "node",
  63. "args": ["/path/to/snip/src/mcp/server.js"]
  64. }
  65. }
  66. }
  67. ```
  68. The MCP server exposes the same capabilities: `render_diagram`, `open_in_snip`, `search_screenshots`, `list_screenshots`, `get_screenshot`, `transcribe_screenshot`, `organize_screenshot`, `get_categories`, `install_extension`.
  69. ## Also a Screenshot Tool
  70. Snip is a full screenshot + annotation app on its own:
  71. - **Cmd+Shift+2** (macOS) / **Ctrl+Shift+2** (Linux) — Capture with region select or window snap
  72. - **Cmd+Shift+1** / **Ctrl+Shift+1** — Quick Snip (capture straight to clipboard)
  73. - **Annotate** — Rectangle, arrow, text, tag, blur brush, AI segment
  74. - **Esc** — Copy to clipboard and close
  75. - **Cmd+S** — Save to disk + AI organizes in background
  76. AI organization uses a local vision LLM (via [Ollama](https://ollama.com/download)) to name, categorize, and tag every saved screenshot. Semantic search finds any screenshot by describing what was in it.
  77. ## Key Shortcuts
  78. On Linux, replace Cmd with Ctrl.
  79. | Shortcut | Action |
  80. |----------|--------|
  81. | Cmd+Shift+2 | Capture screenshot |
  82. | Cmd+Shift+1 | Quick Snip (select & copy to clipboard) |
  83. | Cmd+Shift+S | Open semantic search |
  84. | Cmd+S | Save to disk (in editor) |
  85. | Esc / Enter | Copy to clipboard & close (in editor) |
  86. | V / C / R / T / A / G / B / S | Select / Crop / Rectangle / Text / Arrow / Tag / Blur / Segment tools |
  87. | Cmd+Z | Undo (annotations first, then crop, then segment cutout) |
  88. ## Development
  89. ```bash
  90. npm install
  91. npm run rebuild # compile native modules (macOS)
  92. npm start # launch (tray icon appears)
  93. ```
  94. Requires **macOS 14+** or **Linux (Wayland)**, **Node.js 18+**.
  95. ## Documentation
  96. | Doc | Contents |
  97. |-----|----------|
  98. | [`docs/PRODUCT.md`](docs/PRODUCT.md) | Vision, feature specs, terminology |
  99. | [`docs/DESIGN.md`](docs/DESIGN.md) | Color palettes, component patterns, glass effects |
  100. | [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | Code structure, IPC channels, data flow |
  101. | [`docs/DEVOPS.md`](docs/DEVOPS.md) | Build pipeline, signing, native modules |
  102. | [`docs/USER_FLOWS.md`](docs/USER_FLOWS.md) | Step-by-step flows, edge cases, test cases |
  103. ## Tech Stack
  104. Electron 33 / Fabric.js 7 / Mermaid.js 11 / Ollama (local LLM) / HuggingFace Transformers.js / SlimSAM (ONNX)
  105. All AI runs locally — no cloud APIs needed for core features.
  106. ## Sponsor
  107. Snip is free, open source, and built by two developers. If it's useful to your workflow, consider [sponsoring the project](https://github.com/sponsors/rixinhahaha).
  108. Sponsorships help cover:
  109. - **Apple Developer Program** — required for code signing and notarization so macOS doesn't block the app
  110. - **CI/CD costs** — automated builds, testing, and release pipelines for macOS and Linux
  111. - **Continued development** — new annotation tools, better AI integration, Linux improvements, and bug fixes
  112. Every contribution helps keep Snip maintained and improving. Thank you!
  113. ## License
  114. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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