Your notes, terminals and code, one keystroke away, on top of every app.
Press ⌃Space in any app and a translucent panel drops down from the top of your screen, like a window shade. Press it again and it's gone. The app you're in (your meeting, your IDE) stays in front the whole time.
| Feature | What you get | |
|---|---|---|
| 📝 | Notes | Cards as tabs, color groups, saved as you type |
| 🌐 | Live translation | Your notes in another language, side by side, fully on-device |
| 💻 | Terminal cards | Your own shell in the panel, with live titles from Claude Code and Copilot CLI |
| 🔔 | Needs-you alerts | A macOS notification when a background card waits for input |
| 🛡 | Sandbox | Agents can change only the project you pick, and can't read your keys |
| 📡 | Agent Traffic | Every model call and connection an agent makes, with prompts and replies |
| 🗂 | Repo sidebar | Live git changes, diffs, a file editor, Markdown preview and Quick Open |
| 🔒 | Private | Native Swift, no account, no telemetry; nothing leaves your Mac |
Download: grab the latest .dmg from Releases and drag Shade to
Applications. Apple silicon and Intel, macOS 15+.
Note
Releases aren't notarized by Apple yet, so macOS blocks the first launch. Open Shade once, then go to
System Settings › Privacy & Security and click Open Anyway. Or, in Terminal:
xattr -dr com.apple.quarantine /Applications/Shade.app
Build from source (Xcode 26+ / Swift 6.2):
git clone https://github.com/dineshvg/Shade.git && cd Shade && ./scripts/install.shUpdate with git pull && ./scripts/install.sh. More in docs/development.md.
| Shortcut | Action |
|---|---|
| ⌃Space | Show or hide the panel from any app (configurable) |
| Esc | Hide the panel (goes to the terminal in a terminal card) |
| ⌘T / ⇧⌘T | New notes card / new terminal card |
| 🛡 | New sandboxed terminal card |
| ⌘1 … ⌘9 | Switch card |
| ⌘P | Quick Open a file from the card's repository |
| ⌘B | Show or hide the repository sidebar |
| ⌘S | Save a file card |
| 🔴 🟡 🟢 | Hide · roll up to the tabs · fill the screen |
- Cards as tabs, one per meeting or topic. Double-click a tab to rename it.
- Groups like Chrome's tab groups (right-click a card › Add to New Group).
- Resize the panel, change the font size and background opacity. Everything is saved as you type.
- By default it floats above every app; turn off ⚙︎ › Panel › Keep on top of other windows to let windows cover it.
Write in one language, read in another, line by line, as you type. Uses Apple's on-device Translation framework: free, no account, and the text never leaves your Mac. 12 languages, or auto-detect.
-
Your login shell, aliases and tools. Each card keeps running while the panel is hidden.
-
The tab shows the title the program sets, so you can follow Claude Code or Copilot CLI at a glance.
-
Themed 16-color palettes with minimum contrast, so dim hints stay readable in Dark, Light and Paper.
-
🔔 Needs-you alerts when a card you aren't looking at needs input:
Signal Example Program notification (OSC 9 / 777 / 99) Claude Code with /config› Notifications › iTerm2Terminal bell Any tool that rings the bell An agent goes quiet for 5 s Claude Code, Copilot CLI, Codex, Gemini, Aider…
Pick a project folder; everything started in that card is confined by macOS's built-in sandbox.
| Project Only | Strict | |
|---|---|---|
| Write inside the project | ✅ | ✅ |
| Write anywhere else (temp, tool caches and agent state excepted) | ❌ | ❌ |
Read ~/.ssh, ~/.aws, tokens, .netrc… |
❌ | ❌ |
Write git hooks, PATH folders, Claude Code's settings |
❌ | ❌ |
| Network | ✅ | Agent services only, via Record Agent Traffic |
Blocked Actions in the card's bar shows live what the sandbox denied. Details and limits: docs/security.md.
Turn on Record Agent Traffic (🛡 menu, or the card's bar for a card that's already open), and open the Agent Traffic card:
flowchart LR
A["Agent in a<br/>terminal card"] -->|"ANTHROPIC_BASE_URL<br/>OPENAI_BASE_URL"| R["Shade relay<br/>127.0.0.1:18090"]
A -->|"HTTPS_PROXY"| R
R -->|"full request & reply"| M["Anthropic / OpenAI"]
R -->|"host, size, duration"| O["Other hosts<br/>(e.g. GitHub Copilot)"]
R -.-> V["📡 Agent Traffic card"]
| View | Shows |
|---|---|
| List | Every call: model or host, program, status, tokens or bytes, duration |
| Summary | System prompt, last user message, reply, tools offered and used |
| Request / Response | The full model call, pretty-printed |
Recordings stay in memory only and are gone when you quit. How it works: docs/agent-traffic.md.
When a terminal card is inside a git repository, a slim bar shows the branch and the number of changed files.
- Sidebar (⌘B) with Changes and Files; click a file to open it as a card.
- File cards: edit and ⌘S, or view the diff. They reload when an agent changes the file, and never overwrite your unsaved edits without asking.
- Syntax highlighting for ~190 languages and 16 built-in themes, plus Markdown preview.
- Open in your editor: VS Code, Android Studio, Xcode or your default app.
Themes Dark, Light and Paper · Hide from screen sharing (best effort) · Launch at login · Show in Dock · a short welcome screen (?).
- No account, no analytics, no network calls of its own.
- Notes, settings and recorded traffic stay on your Mac.
- The only things that go online are the 🌐 Google Translate button and Get More Themes downloads, and only when you click them.
| Doc | For |
|---|---|
| Security model | What the sandbox and Agent Traffic protect against, and what they don't |
| Agent Traffic | How recording works, Strict mode, agent hosts |
| Troubleshooting | Shortcut conflicts, blocked tools, notifications, build errors |
| Development | Building, code layout, syntax highlighting, releases |
Shade was built by me, Dinesh Gangatharan, together with an AI coding assistant. I decided what Shade does and how it works: the features, the architecture, the security design of the sandbox and of Agent Traffic, and the name. I tested every build on my Mac and reported what broke; the assistant wrote most of the code. Working that way is also why the sandbox and Agent Traffic exist: I wanted to see, and limit, what coding agents do on my machine.
MIT © 2026 Dinesh Gangatharan. Third-party components: THIRD_PARTY_NOTICES.md.
Provided as is, without warranty of any kind. "Hide from screen sharing" is best effort, and the sandbox reduces what a program can reach but is not a guarantee against a determined attacker. Use at your own risk.