Caldis/Pir

Latest recorded source activity: October 29, 2026 at 17:12

SkillsMP catalog refreshed: November 5, 2026 at 19:57

skills collected: 1

GitHub stars: 2
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Caldis/Pir.

Repository README

Repository README source: README.md

Read the source README

Expand full README

<p align="center"> <img src="assets/brand/app-icon.png" width="128" height="128" alt="Pir app icon"> </p> <h1 align="center">Pir</h1> <p align="center">Copy it. Keep it in sight.</p> <p align="center"> <a href="https://pir.caldis.me/">Website</a> · <a href="https://github.com/Caldis/Pir/releases/latest">Download</a> </p> <p align="center">English · <a href="README.zh-CN.md">简体中文</a></p> Pir is a native macOS menu bar app that keeps clipboard images, editable text, and file references in always-on-top, borderless windows. Move and resize each window to keep what you need within reach. ## Features ### Images <img src="website/assets/usage-image.png" width="397" alt="Image pinned in Pir"> - Pin images from your clipboard, including transparent images and Retina screenshots with their logical display size preserved. - Switch between filling the window with a crop and fitting the whole image. The window keeps its size and position; your display mode is saved and carried over when you pin it again. - Copy the original image from the floating window. ### Text <img src="website/assets/usage-text.png" width="387" alt="Editable text pinned in Pir"> - Select, edit, and copy text directly in a window. Edits are restored when Pir restarts. - Drag the space at the top to move the window, or hold `Option` while dragging the text. Resize from the edges; narrow windows wrap text and scroll vertically. - Text and background colors follow the macOS appearance. New text windows trim leading and trailing whitespace without changing your clipboard or internal formatting. ### Files <img src="website/assets/usage-files.png" width="376" alt="Files pinned in Pir with native icons"> - Copy files or folders in Finder, then pin them as references with native icons or a list view. - Select by dragging a selection rectangle, toggle items with `Command`, add to a selection with `Shift`, double-click to open, or drag files to Finder. - Right-click to open, move to Trash, get info, rename, reveal in Finder, or remove from the list. Get Info opens Pir's native file information windows with selectable, copyable fields. Batch renaming numbers files and preserves extensions. **File actions affect the original files.** Renaming and moving to Trash update references across windows, including files inside affected folders. Only successfully trashed items and their descendant references are removed. **Remove from List** removes only the window's references and keeps the original files; removing the last item closes the window. ## Get started Requires **macOS 13 or later**, on Apple Silicon or Intel Macs. [Download the latest disk image](https://github.com/Caldis/Pir/releases/latest), drag Pir into Applications, then open it and complete the welcome screen. You can record a shortcut and try pinning the Pir logo there. 1. **Copy.** Copy an image, some text, or files and folders in Finder. 2. **Pin.** Press **`⇧⌘V`** (`Shift` + `Command` + `V`) in any app. A saved custom shortcut continues to work. 3. **Arrange.** Drag a window to move it and use its edges to resize. Hover over it to reveal the controls in the upper-left corner. For text, drag the space at the top or hold `Option` while dragging the text. | Window | Controls, from left to right | | --- | --- | | Image | Close, restore size, display mode, copy | | Text | Close, restore size, copy | | Files | Close, restore size | The copy button briefly shows a checkmark after a successful copy. Global shortcuts and shortcut recording require no Accessibility permission. ## Preferences and recovery Click the menu bar icon and choose **Preferences**. The four tabs are General, Windows, Updates, and About. | General setting | What it does | | --- | --- | | Launch at login | Starts Pir when you log in to macOS | | Hide menu bar icon | Hides the icon; open Pir again to access Preferences | | Shortcut | Records or clears the global shortcut used to pin content | The **Windows** tab lists all windows and lets you pin them again, show, hide, delete, or clear all after confirmation. Hidden states persist across restarts. Pir restores window content, sizes, and positions on restart, with placement saved for each display. After onboarding, regular launches stay quiet. Open Pir again while it is running to show Preferences, including when its menu bar icon is hidden. In **Updates**, you can check manually or enable checks at startup. Updates come from Pir's GitHub Releases through Sparkle. ## Local storage and privacy Pir reads the clipboard when you trigger it. Window sessions are stored locally in `~/.config/pir/`; closing a window removes its saved record. File windows retain file URL references. Closing a file window or removing a reference does not delete the original file; **Move to Trash** acts on the original file. ## License Pir uses the [Pir Source License 1.0](LICENSE), a **source-available** license. It permits use, copying, modification, and distribution, including selling copies, subject to its terms. Copies must retain the license and copyright notice; modified distributions must identify their changes and must not present themselves as official Pir releases. Distributing a covered application through an application marketplace, free or paid, requires separate written permission from Caldis / BIAO CHEN. The license defines covered applications and marketplaces; the copyright holder retains their own distribution rights. This is **not the MIT License or an OSI-approved open source license**. Third-party components keep their own licenses; see [third-party notices](THIRD_PARTY_NOTICES.md).

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

pir-maintainer

unclassified

Use when maintaining Caldis/Pir GitHub issues or Project

2026-10-29

Showing 1 of 1 collected skill.