https://github.com/andrewmmc/clipwise
Select text anywhere, transform it with AI, get the result in your clipboard.
https://github.com/andrewmmc/clipwise
chatgpt claude codex gpt llm macos
Last synced: 30 days ago
JSON representation
Select text anywhere, transform it with AI, get the result in your clipboard.
- Host: GitHub
- URL: https://github.com/andrewmmc/clipwise
- Owner: andrewmmc
- License: mit
- Created: 2026-04-09T13:56:41.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-05-31T11:38:11.000Z (about 1 month ago)
- Last Synced: 2026-05-31T13:04:40.393Z (about 1 month ago)
- Topics: chatgpt, claude, codex, gpt, llm, macos
- Language: TypeScript
- Homepage: https://clipwise.mmc.dev
- Size: 5.95 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
Clipwise
macOS menu bar app for LLM-powered text transformations.
Clipwise is a small menu bar app that helps you quickly rewrite, summarize, translate, and clean up text anywhere on macOS. Copy text in any app, pick an action from the menu bar, and Clipwise puts the improved result back on your clipboard so you can paste it right away. On Macs that support Apple Intelligence, it can use the built-in on-device model automatically; you can also connect OpenAI-compatible, Anthropic, or local CLI tools.
No browser. No context switching. Select text, run an action, get the result back in your clipboard.
## Screenshots
Define reusable actions
Create custom prompt + provider combinations for text transformations like rewriting, translating, and more.
Manage providers
Use Apple Intelligence automatically on supported Macs, or connect OpenAI, Anthropic, and local CLI tools like copilot and claude.
Review history
Browse past transformations with input/output details and quick copy.
Configure settings
Toggle notifications, enable history, and set max token limits.
## Download
**[Get Clipwise on the Mac App Store](https://apps.apple.com/us/app/clipwise-refine-text-with-ai/id6762086471)** (Apple Intelligence, OpenAI, Anthropic) or **[download the latest release](https://github.com/andrewmmc/clipwise/releases/latest)** (includes CLI tool support)
macOS builds are available for both Apple Silicon (M1+) and Intel.
### From the Mac App Store
1. Open the [App Store link](https://apps.apple.com/us/app/clipwise-refine-text-with-ai/id6762086471) and click **Get**.
2. The app will be installed to your **Applications** folder automatically.
### From GitHub Releases
1. Download the `.dmg` file from the [releases page](https://github.com/andrewmmc/clipwise/releases/latest) for your architecture.
2. Open the `.dmg` and drag **Clipwise** to your **Applications** folder.
3. On first launch, macOS may block the app. Go to **System Settings → Privacy & Security** and click **Open Anyway**.
## How to Use
1. **Open settings** — launch Clipwise and open the settings window from the menu bar.
2. **Check providers** — if your Mac supports Apple Intelligence, the Apple provider is added automatically. Otherwise add an LLM provider manually (OpenAI-compatible, Anthropic, or a CLI tool).
3. **Create an action** — define a prompt and select a provider (for example, "Refine wording" with Apple Intelligence or OpenAI).
4. **Copy text** — select and copy text in any app.
5. **Run the action** — click the Clipwise icon in the menu bar and select an action.
6. **Paste the result** — the transformed text is written back to your clipboard, ready to paste.
## Why Clipwise
- **System-wide access** — trigger actions from the menu bar in any app without switching context
- **Multi-provider support** — Apple Intelligence on supported Macs, plus OpenAI, Anthropic, any OpenAI-compatible endpoint, and local CLI tools like `claude` or `codex`
- **Custom actions** — define reusable prompt + provider combinations for your specific workflows
- **Local-first** — no backend, no telemetry; on-device Apple Intelligence, API keys, and config stay on your machine
## Features
- **Menu bar app** — runs as a tray app with no Dock presence
- **Settings UI** — manage providers, actions, and app settings from a dedicated window
- **Apple Intelligence support** — auto-attaches the on-device Apple provider when the current Mac supports it
- **Clipboard workflow** — reads text from clipboard, runs the action, writes result back
- **Action testing** — test actions directly in the settings UI before using them
- **Notifications** — optional macOS notifications when actions complete
- **Reorderable actions** — drag to reorder actions in the menu
- **History** — browse past transformations with input/output details
## Providers
Clipwise supports two provider modes:
- **Apple Intelligence** — on supported Macs, Clipwise auto-adds the built-in on-device Apple provider. No API key is required.
- **BYOK / local tools** — for Anthropic, OpenAI-compatible APIs, and CLI tools, you provide your own API keys or local commands. No keys are included or shared. You can get started for free with [OpenRouter's free models](https://openrouter.ai/openrouter/free).
- **OpenAI-compatible** — works with OpenAI, OpenRouter, local gateways, and other compatible chat completion endpoints
- **Anthropic** — direct Anthropic API requests
- **CLI** — local CLI commands like `claude`, `codex`, or custom scripts
## Development
> **Note:** This section is for contributors and developers only.
### Prerequisites
- macOS
- Node.js 22+
- [Rust](https://www.rust-lang.org/tools/install)
- Xcode Command Line Tools
### Quick start
```bash
npm install
npm run tauri:dev # full Tauri app
```
### Build modes
Clipwise supports two build modes via a Cargo feature flag:
| Mode | CLI Provider | Use case |
| --------------------------- | ------------ | ------------------------------------------------------ |
| **Default** (with CLI) | Yes | Development, non-App-Store distribution (DMG/Homebrew) |
| **App Store** (without CLI) | No | Mac App Store submission (sandbox-compliant) |
The `cli-provider` feature is enabled by default.
```bash
# Default build (with CLI provider)
npm run tauri:dev
npm run tauri:build
npm run tauri:build-debug
# App Store build (without CLI provider)
npm run tauri:dev:appstore
npm run tauri:build:appstore
```
> **Why two modes?** The Mac App Store requires the App Sandbox, which prevents running arbitrary subprocesses. CLI providers (e.g. `claude`, `codex`) execute local commands and are incompatible with sandboxing. The UI automatically hides the CLI option when the build doesn't support it.
### Commands
```bash
npm run dev # Vite dev server only
npm run build # tsc + Vite build
npm run tauri:dev # full Tauri app (dev, with CLI)
npm run tauri:dev:appstore # full Tauri app (dev, without CLI / App Store mode)
npm run tauri:build # production build (with CLI)
npm run tauri:build:appstore # production build (App Store)
npm run tauri:build-debug # debug .app bundle
npm run lint # ESLint
npm run typecheck # TypeScript check
npm run format # Prettier
npm test # Vitest
cd src-tauri && cargo test # Rust tests (default features)
cd src-tauri && cargo test --no-default-features # Rust tests (App Store mode)
```
### Testing macOS build
To test a built `.app` bundle:
```bash
# Default build (with CLI provider)
npm run tauri:build-debug
# Output: src-tauri/target/debug/bundle/macos/Clipwise.app
# App Store build (without CLI provider)
npm run tauri:dev:appstore
```
### Tech stack
React 19, TypeScript, Vite 7, Tailwind CSS v4, Tauri 2, Vitest.
See **[AGENTS.md](./AGENTS.md)** for architecture, conventions, and contributor docs.
## Architecture
```text
src/ React + TypeScript settings UI (Vite, Tailwind CSS v4)
src-tauri/ Rust backend: tray app, config persistence, provider calls
```
## Configuration
Config is stored at `~/Library/Application Support/clipwise/config.json`:
```json
{
"providers": [
{
"id": "apple-intelligence",
"name": "Apple Intelligence",
"type": "apple"
}
],
"actions": [],
"settings": {
"showNotificationOnComplete": true,
"maxTokens": 4096,
"historyEnabled": true
}
}
```
On Macs without Apple Intelligence support, `providers` may start as an empty array until you add one manually.
## Author
Created by **Andrew Mok** ([@andrewmmc](https://github.com/andrewmmc))
## License
[MIT](./LICENSE)