1
0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2025-12-12 15:34:50 +08:00

Compare commits

...

3 Commits

Author SHA1 Message Date
Paul Frederiksen
868d96c4c0
Merge f66703b07e into 72acd2ca90 2025-12-08 08:32:57 -08:00
Mohaiminus Sakib
72acd2ca90
feat(uv): add more useful aliases (#13462)
Co-authored-by: Mohaiminus Sakib <roddur093@gmail.com>
Co-authored-by: Marc Cornellà <marc@mcornella.com>
2025-12-08 16:57:50 +01:00
Paul Frederiksen
f66703b07e Add OSC52 clipboard support for SSH/remote terminals
- Implement OSC52 clipboard copy support using terminal escape sequences
- Add detection for OSC52-capable terminals (iTerm2, WezTerm, foot, Alacritty, etc.)
- Integrate OSC52 into clipboard detection chain (after SSH tools, before tmux)
- Update documentation to include OSC52 in supported methods

Fixes #13459
2025-12-06 10:20:59 -08:00
3 changed files with 114 additions and 18 deletions

View File

@ -14,6 +14,7 @@
# - xclip (if $DISPLAY is set)
# - lemonade (for SSH) https://github.com/pocke/lemonade
# - doitclient (for SSH) http://www.chiark.greenend.org.uk/~sgtatham/doit/
# - OSC52 (for SSH/remote terminals) https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-Operating-System-Commands
# - win32yank (Windows)
# - tmux (if $TMUX is set)
#
@ -48,6 +49,76 @@
# # Paste to a file
# clippaste > file.txt
#
# Check if terminal supports OSC52 escape sequences for clipboard operations
# OSC52 allows copying to clipboard through terminal escape sequences, useful for SSH sessions
function _osc52_supported() {
emulate -L zsh
# Check for known OSC52-capable terminals
# iTerm2, WezTerm, foot, Alacritty, and many modern terminals support OSC52
[[ -n "${ITERM_SESSION_ID:-}" ]] && return 0
[[ -n "${WEZTERM_PANE:-}" ]] && return 0
[[ "$TERM" =~ ^(foot|alacritty|kitty|rxvt-unicode|xterm) ]] && return 0
# Check if we're in a terminal that likely supports OSC52
# Most modern terminals support it, but we'll be conservative
[[ -t 1 ]] && [[ -n "${TERM:-}" ]] && return 0
return 1
}
# Copy to clipboard using OSC52 escape sequence
# OSC52 format: \033]52;c;<base64-data>\033\\
function _osc52_copy() {
emulate -L zsh
# Read input (file or stdin)
local input="${1:-/dev/stdin}"
local data
data=$(cat "$input" 2>/dev/null)
if [[ -z "$data" ]]; then
return 1
fi
# Base64 encode the data
# base64 command is standard on most Unix-like systems
local base64_data
if (( ${+commands[base64]} )); then
base64_data=$(printf '%s' "$data" | base64 | tr -d '\n')
elif (( ${+commands[python3]} )); then
base64_data=$(printf '%s' "$data" | python3 -m base64 2>/dev/null | tr -d '\n')
elif (( ${+commands[python]} )); then
base64_data=$(printf '%s' "$data" | python -m base64 2>/dev/null | tr -d '\n')
else
print "osc52: base64 encoder not found" >&2
return 1
fi
if [[ -z "$base64_data" ]]; then
return 1
fi
# Send OSC52 escape sequence to terminal
printf '\033]52;c;%s\033\\' "$base64_data"
}
# Paste from clipboard using OSC52 escape sequence
# Note: Paste support is less common than copy support
function _osc52_paste() {
emulate -L zsh
# Query clipboard using OSC52
# Format: \033]52;c;?\033\\
printf '\033]52;c;?\033\\'
# Note: Most terminals don't support OSC52 paste queries reliably
# This is a best-effort implementation
# The terminal would need to respond with the clipboard content
# For now, we'll return an error to fall back to other methods
return 1
}
function detect-clipboard() {
emulate -L zsh
@ -75,6 +146,18 @@ function detect-clipboard() {
elif (( ${+commands[doitclient]} )); then
function clipcopy() { cat "${1:-/dev/stdin}" | doitclient wclip; }
function clippaste() { doitclient wclip -r; }
elif _osc52_supported; then
# OSC52 clipboard support for SSH/remote terminals
# Copy works reliably in most modern terminals (iTerm2, WezTerm, foot, Alacritty, etc.)
# Paste support is limited - most terminals don't support OSC52 paste queries reliably
function clipcopy() { _osc52_copy "${1:-/dev/stdin}"; }
function clippaste() {
# OSC52 paste query support is unreliable across terminals
# For now, we don't implement paste via OSC52 as it's not widely supported
# Users can use other methods (tmux, terminal-specific paste) for pasting
print "clippaste: OSC52 paste not supported. Try tmux or terminal-specific paste." >&2
return 1
}
elif (( ${+commands[win32yank]} )); then
function clipcopy() { cat "${1:-/dev/stdin}" | win32yank -i; }
function clippaste() { win32yank -o; }

View File

@ -1,6 +1,7 @@
# uv plugin
This plugin automatically installs [uv](https://github.com/astral-sh/uv)'s completions for you, and keeps them up to date. It also adds convenient aliases for common usage.
This plugin automatically installs [uv](https://github.com/astral-sh/uv)'s completions for you,
and keeps them up to date. It also adds convenient aliases for common usage.
To use it, add `uv` to the plugins array in your zshrc file:
@ -10,20 +11,26 @@ plugins=(... uv)
## Aliases
| Alias | Command | Description |
|:----- |------------------------------------------------------------------------ |:-------------------------------------------------------------------- |
| uva | `uv add` | Add packages to the project |
| uvexp | `uv export --format requirements-txt --no-hashes --output-file requirements.txt --quiet` | Export the lock file to `requirements.txt` |
| uvl | `uv lock` | Lock the dependencies |
| uvlr | `uv lock --refresh` | Rebuild the lock file without upgrading dependencies |
| uvlu | `uv lock --upgrade` | Lock the dependencies to the newest compatible versions |
| uvp | `uv pip` | Manage pip packages |
| uvpy | `uv python` | Manage Python installs |
| uvpp | `uv python pin` | Pin the current project to use a specific Python version |
| uvr | `uv run` | Run commands within the project's environment |
| uvrm | `uv remove` | Remove packages from the project |
| uvs | `uv sync` | Sync the environment with the lock file |
| uvsr | `uv sync --refresh` | "Force" sync the environment with the lock file (ignore cache) |
| uvsu | `uv sync --upgrade` | Sync the environment, allowing upgrades and ignoring the lock file |
| uvup | `uv self update` | Update the UV tool to the latest version |
| uvv | `uv venv` | Manage virtual environments |
| Alias | Command | Description |
| :---- | ---------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| uva | `uv add` | Add packages to the project |
| uvexp | `uv export --format requirements-txt --no-hashes --output-file requirements.txt --quiet` | Export the lock file to `requirements.txt` |
| uvi | `uv init` | Initialize a new project in current workspace and environment. |
| uvinw | `uv init --no-workspace` | Initialize a new project in a new workspace and environment |
| uvl | `uv lock` | Lock the dependencies |
| uvlr | `uv lock --refresh` | Rebuild the lock file without upgrading dependencies |
| uvlu | `uv lock --upgrade` | Lock the dependencies to the newest compatible versions |
| uvp | `uv pip` | Manage pip packages |
| uvpi | `uv python install` | Install a specific version of python |
| uvpl | `uv python list` | Lists all python version installed |
| uvpp | `uv python pin` | Pin the current project to use a specific Python version |
| uvpu | `uv python uninstall` | Remove a specific version of python |
| uvpy | `uv python` | Manage Python installs |
| uvr | `uv run` | Run commands within the project's environment |
| uvrm | `uv remove` | Remove packages from the project |
| uvs | `uv sync` | Sync the environment with the lock file |
| uvsr | `uv sync --refresh` | "Force" sync the environment with the lock file (ignore cache) |
| uvsu | `uv sync --upgrade` | Sync the environment, allowing upgrades and ignoring the lock file |
| uvtr | `uv tree` | Displays the full dependency tree for the current project environment |
| uvup | `uv self update` | Update the UV tool to the latest version |
| uvv | `uv venv` | Manage virtual environments |

View File

@ -7,10 +7,15 @@ alias uv="noglob uv"
alias uva='uv add'
alias uvexp='uv export --format requirements-txt --no-hashes --output-file requirements.txt --quiet'
alias uvi='uv init'
alias uvinw='uv init --no-workspace'
alias uvl='uv lock'
alias uvlr='uv lock --refresh'
alias uvlu='uv lock --upgrade'
alias uvp='uv pip'
alias uvpi='uv python install'
alias uvpl='uv python list'
alias uvpu='uv python uninstall'
alias uvpy='uv python'
alias uvpp='uv python pin'
alias uvr='uv run'
@ -18,6 +23,7 @@ alias uvrm='uv remove'
alias uvs='uv sync'
alias uvsr='uv sync --refresh'
alias uvsu='uv sync --upgrade'
alias uvtr='uv tree'
alias uvup='uv self update'
alias uvv='uv venv'