Security for terminal --tags
How terminal --tags handles your data, where it stores your tags, how updates are delivered, and what happens if your subscription lapses.
Permissions we request and why
Mac: Accessibility is required so terminal --tags can draw floating colored tag overlays on top of other apps' windows and observe window positions. No other elevated permission is requested.
Windows: No elevated permissions. terminal --tags runs as a standard user.
Tag storage
Tags (the label text, color, and which window they're attached to) are stored in a plaintext JSON file in your user data directory:
- Mac:
~/Library/Application Support/TerminalTags/tags.json - Windows:
%APPDATA%\TerminalTags\tags.json
terminal --tags never reads the contents of your terminals. It only labels windows — the text scrolling inside a tagged window is never captured, stored, or transmitted.
Updates
Today: Manual updates only. Grab the latest build from the download page. Your existing install keeps running regardless.
Coming soon: Signed automatic updates on both platforms. We will announce the version that ships it in the changelog.
Telemetry
Product analytics collect anonymous product events: app launch, hotkey usage, and paywall view. We never transmit your tag labels, window titles, or anything about the terminals you tag.
Our payments processor handles license verification only.
One-time license
- A single $19.99 purchase unlocks Terminal Tags on Mac, Windows, and Linux — no subscription.
- All future updates are included.
- Your tags and settings stay readable and exportable on your machine.
Reporting security issues
Email security@bravely.dev. PGP fingerprint or plain text are both fine.