https://github.com/thejoaov/tray-link
Menu bar app and CLI to open, organize, and launch local projects faster.
https://github.com/thejoaov/tray-link
bun cli developer-tools electron github-desktop linux macos menu-bar productivity react-native system-tray tray typescript windows
Last synced: about 1 month ago
JSON representation
Menu bar app and CLI to open, organize, and launch local projects faster.
- Host: GitHub
- URL: https://github.com/thejoaov/tray-link
- Owner: thejoaov
- License: mit
- Created: 2019-10-18T16:07:59.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2026-04-17T05:21:12.000Z (about 1 month ago)
- Last Synced: 2026-04-17T06:27:55.909Z (about 1 month ago)
- Topics: bun, cli, developer-tools, electron, github-desktop, linux, macos, menu-bar, productivity, react-native, system-tray, tray, typescript, windows
- Language: TypeScript
- Homepage: https://tray-link-docs.vercel.app
- Size: 73.4 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
Tray Link
System tray app to quickly open and manage your local projects.
## Overview
Tray Link helps you keep your favorite projects one click away from the menu bar/tray.
Documentation: [tray-link-docs.vercel.app](https://tray-link-docs.vercel.app)
With it, you can:
- Open a project folder quickly
- Open projects directly in your preferred editor
- Open projects in your preferred terminal
- Open repositories in GitHub Desktop
- Use the app in Portuguese (Brazil), English, or Spanish
## Monorepo structure
- `apps/menu-bar`: Desktop app (React Native + Expo + Electron bridge)
- `apps/cli`: CLI used by Tray Link
- `packages/*`: Shared types and modules
## Tech stack
- Bun workspaces
- TurboRepo
- TypeScript
- Expo + React Native (macOS/Web)
- Electron tooling integration
## Requirements
- Node.js `>=20`
- Bun `1.x`
## Getting started
1. Clone this repository
2. Install dependencies:
```bash
bun install
```
3. Start development mode from the monorepo root:
```bash
bun run dev
```
## Useful scripts (root)
- `bun run dev`: Run all workspace dev pipelines
- `bun run build`: Build all workspaces
- `bun run lint`: Run Biome lint
- `bun run typecheck`: Run TypeScript checks across workspaces
- `bun run start:metro`: Start Expo Metro for the menu-bar app
- `bun run macos`: Build/run macOS target for the menu-bar app
- `bun run electron:dev`: Export web bundle and start Electron
- `bun run electron:package`: Package Electron app
## Download
Prebuilt binaries are available in [Releases](https://github.com/thejoaov/tray-link/releases).
### Install with Homebrew (macOS)
```bash
brew tap thejoaov/tap
brew install --cask tray-link
```
The Homebrew cask installs both `Tray Link.app` and the `tlink` CLI.
To update later:
```bash
brew upgrade --cask tray-link
```
### Homebrew maintainers
- Cask file: [`thejoaov/homebrew-tap`](https://github.com/thejoaov/homebrew-tap)
- Release sync workflow: `.github/workflows/homebrew-cask-sync.yml`
## Signing disclaimer
This application is not signed yet. If you prefer, clone the repository and run/build it locally.
To force the signing on macOS, you can use the following command:
```bash
xattr -d com.apple.quarantine /Applications/Tray\ Link.app
```
## License and attribution
This project is heavily inspired by the excellent work of [Expo Orbit](https://github.com/expo/orbit).
This project is licensed under the MIT License. See [LICENSE.md](LICENSE.md).