Files
arthur-os/shell/plugins/tailscale/README.md
T
2026-05-26 11:27:11 -04:00

39 lines
1.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Tailscale Omarchy Widget
Native Omarchy bar widget for Tailscale.
## Features
- Shows Tailscale connection state in the bar
- Left click opens a keyboard-friendly panel
- Right click toggles Tailscale on/off
- Switch between logged-in Tailscale accounts when multiple are available
- Browse peers from `tailscale status --json`
- Copy a peer's Tailscale IP, host name, or DNS name
## Keyboard shortcuts
Inside the panel:
- `j` / `k` or arrows: move cursor
- `enter` / `space`: activate current row
- `c`: copy selected peer IP
- `n`: copy selected peer name
- `d`: copy selected peer DNS name
- `t`: toggle Tailscale
- `r`: refresh status
- `esc`: close
## Requirements
- `tailscale` CLI on `PATH`
- `wl-copy` for clipboard copy actions
## Icon
Renders the Tailscale mark natively as a theme-colored 3×3 dot grid, matching the official SVG silhouette while avoiding tiny-SVG rendering quirks in the bar.
## Add to the bar
This widget ships as first-party plugin `omarchy.tailscale`. Add it through Omarchy's bar settings UI, or add an entry such as `{ "id": "omarchy.tailscale" }` to one of the `bar.layout` sections in `~/.config/omarchy/shell.json` and restart the shell.