https://github.com/chigichan24/deree
*D*oes *E*very *R*obot-*E*xcluded *E*dit — A clipboard image history for the work AI leaves behind. Your agent writes the code — you paste the screenshots.
https://github.com/chigichan24/deree
macapp swiftui
Last synced: about 2 months ago
JSON representation
*D*oes *E*very *R*obot-*E*xcluded *E*dit — A clipboard image history for the work AI leaves behind. Your agent writes the code — you paste the screenshots.
- Host: GitHub
- URL: https://github.com/chigichan24/deree
- Owner: chigichan24
- License: apache-2.0
- Created: 2026-03-15T16:24:59.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-21T06:05:01.000Z (2 months ago)
- Last Synced: 2026-03-21T07:49:05.336Z (2 months ago)
- Topics: macapp, swiftui
- Language: Swift
- Homepage:
- Size: 1.25 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# deree
**D**oes **E**very **R**obot-**E**xcluded **E**dit
A clipboard image history for the work AI leaves behind. Your AI agent can write the code and take the screenshots, but someone still has to paste them into the PR. That someone is you. deree keeps your clipboard images ready so the last mile hurts a little less.
## Features
- Clipboard image history displayed in a floating side panel on the right edge of the screen
- Automatically captures images from screenshots, app copies, and Finder file copies (Cmd+C)
- Click a thumbnail to copy it back to the clipboard
- Keeps the last 50 images, older ones are automatically cleaned up
- Panel slides in/out from the right edge with animation
- Click the menu bar icon to toggle the panel instantly
- Panel auto-hides when you switch to another app
- Persists history across app restarts
- Runs as a menu bar app (no Dock icon)
## Requirements
- macOS 14.0 (Sonoma) or later
- Xcode 26.0 or later (Swift 6)
- [Mint](https://github.com/yonaskolb/Mint) (CLI tool manager)
## Install
```bash
# Install Mint (manages XcodeGen and other CLI tools)
brew install mint
# Clone and enter the repo
git clone https://github.com/chigichan24/deree.git && cd deree
# Install CLI dependencies (XcodeGen, pinned in Mintfile)
mint bootstrap
# Generate Xcode project from project.yml
mint run xcodegen generate
# Build a Release binary
xcodebuild -project deree.xcodeproj -scheme deree -configuration Release \
-destination 'platform=macOS' -skipMacroValidation \
-derivedDataPath build
# Copy to Applications and launch
cp -r build/Build/Products/Release/deree.app /Applications/
open /Applications/deree.app
```
To launch at login, add deree in System Settings → General → Login Items.
## Development
```bash
# Generate Xcode project (re-run after editing project.yml)
mint run xcodegen generate
# Build (debug)
xcodebuild -project deree.xcodeproj -scheme deree \
-destination 'platform=macOS' -skipMacroValidation build
# Run tests
xcodebuild -project deree.xcodeproj -scheme dereeTests \
-destination 'platform=macOS' -skipMacroValidation test
```
Or open `deree.xcodeproj` in Xcode after running `mint run xcodegen generate`.
> **Note:** `-skipMacroValidation` is required because TCA uses Swift macros from SPM packages.
All warnings are treated as errors (`SWIFT_TREAT_WARNINGS_AS_ERRORS`, `GCC_TREAT_WARNINGS_AS_ERRORS`).
## Usage
1. Launch the app -- an icon appears in the menu bar (may be hidden behind the notch on MacBooks)
2. Copy any image (screenshot, browser, Figma, Finder Cmd+C on image files, etc.)
3. Left-click the menu bar icon to slide in the panel
4. Click a thumbnail to copy it back to the clipboard
5. Left-click the icon again, or switch to another app, to slide the panel away
6. Right-click the menu bar icon to quit
## Data Storage
Images are stored in `~/Library/Application Support/deree/`. To reset all data, quit the app and delete that directory.
## Docs
- [Architecture](docs/architecture.md) -- TCA feature composition, data flow, concurrency model