mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2026-03-27 03:14:56 +01:00
Merge 040365a0ed into 11c1718983
This commit is contained in:
Mauricio Silva
GitHub
commit
0114599776
2 changed files with 267 additions and 0 deletions
94
plugins/claude-code/README.md
Normal file
94
plugins/claude-code/README.md
Normal file
|
|
@ -0,0 +1,94 @@
|
|||
# Claude Code Plugin
|
||||
|
||||
The `claude-code` plugin adds several aliases and helper functions for [Claude Code](https://github.com/anthropics/claude-code), the CLI for Claude.
|
||||
|
||||
To use it, add `claude-code` to the plugins array of your zshrc file:
|
||||
|
||||
```zsh
|
||||
plugins=(... claude-code)
|
||||
```
|
||||
|
||||
## Configuration Variables
|
||||
|
||||
Set these in your `~/.zshrc` **before** the plugins line:
|
||||
|
||||
| Variable | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `ZSH_CLAUDE_DEFAULT_MODEL` | _(unset)_ | Default model applied to all session aliases (e.g., `opus`, `sonnet`, `haiku`, or a full model ID) |
|
||||
| `ZSH_CLAUDE_DEFAULT_EFFORT` | _(unset)_ | Default reasoning effort level (`low`, `medium`, `high`, `max`) |
|
||||
| `ZSH_CLAUDE_DEFAULT_PERMISSION_MODE` | _(unset)_ | Default permission mode (`acceptEdits`, `bypassPermissions`, `default`, `dontAsk`, `plan`, `auto`) |
|
||||
| `ZSH_CLAUDE_AUTO_CONTINUE` | `false` | Auto-resume last conversation on new shell start |
|
||||
|
||||
> **How defaults work:** All session-starting aliases (`cl`, `clc`, `clr`, `cln`, `clw`, etc.) automatically
|
||||
> inject your configured defaults. If you also pass a flag explicitly (e.g., `cl --model opus`), the explicit
|
||||
> flag takes precedence since it appears after the defaults on the command line.
|
||||
|
||||
### Example
|
||||
|
||||
```zsh
|
||||
# ~/.zshrc
|
||||
ZSH_CLAUDE_DEFAULT_MODEL="sonnet"
|
||||
ZSH_CLAUDE_DEFAULT_EFFORT="high"
|
||||
ZSH_CLAUDE_DEFAULT_PERMISSION_MODE="plan"
|
||||
ZSH_CLAUDE_AUTO_CONTINUE=false
|
||||
|
||||
plugins=(... claude-code)
|
||||
```
|
||||
|
||||
## Aliases
|
||||
|
||||
### Core
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|---------|-------------|
|
||||
| `cl` | `claude` | Start interactive session |
|
||||
| `clc` | `claude --continue` | Continue last conversation |
|
||||
| `clr` | `claude --resume` | Open session picker |
|
||||
| `clp` | `claude -p` | Headless/print mode |
|
||||
| `clv` | `claude --version` | Show version |
|
||||
| `clu` | `claude update` | Update Claude Code |
|
||||
|
||||
### Sessions
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|---------|-------------|
|
||||
| `cln` | `claude -n` | Start a named session |
|
||||
| `clw` | `claude -w` | Start in a git worktree |
|
||||
| `clfork` | `claude --fork-session` | Fork current session |
|
||||
|
||||
### Auth
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|---------|-------------|
|
||||
| `clas` | `claude auth status` | Check auth status |
|
||||
| `clal` | `claude auth login` | Sign in |
|
||||
| `clao` | `claude auth logout` | Sign out |
|
||||
|
||||
### Config
|
||||
|
||||
| Alias | Command | Description |
|
||||
|-------|---------|-------------|
|
||||
| `clmcp` | `claude mcp` | Manage MCP servers |
|
||||
| `clag` | `claude agents` | List configured agents |
|
||||
|
||||
### Channels
|
||||
|
||||
| Alias | Command | Description | Plugin Install |
|
||||
|-------|---------|-------------|----------------|
|
||||
| `clch-tg` | `claude --channels plugin:telegram@...` | Start with Telegram channel | `/plugin install telegram@claude-plugins-official` |
|
||||
| `clch-dc` | `claude --channels plugin:discord@...` | Start with Discord channel | `/plugin install discord@claude-plugins-official` |
|
||||
| `clch <spec>` | `claude --channels <spec>` | Start with custom channel | — |
|
||||
|
||||
## Functions
|
||||
|
||||
| Function | Description | Example |
|
||||
|----------|-------------|---------|
|
||||
| `clm <model>` | Start with a specific model (also applies effort and permission-mode defaults) | `clm opus` |
|
||||
| `cle <effort>` | Start with a specific effort level (also applies model and permission-mode defaults) | `cle high` |
|
||||
| `clds` | Directory session — create or resume a session named after `$PWD` | `clds` |
|
||||
| `clfp <pr>` | Resume sessions linked to a GitHub PR | `clfp 123` |
|
||||
|
||||
## Tab Completion
|
||||
|
||||
- `clm [TAB]` — completes model names (`opus`, `sonnet`, `haiku`)
|
||||
- `cle [TAB]` — completes effort levels (`low`, `medium`, `high`, `max`)
|
||||
173
plugins/claude-code/claude-code.plugin.zsh
Normal file
173
plugins/claude-code/claude-code.plugin.zsh
Normal file
|
|
@ -0,0 +1,173 @@
|
|||
# Claude Code - Oh My Zsh Plugin
|
||||
# Aliases and helpers for the Claude Code CLI
|
||||
# https://github.com/anthropics/claude-code
|
||||
|
||||
# Prerequisite check
|
||||
|
||||
if ! (( $+commands[claude] )); then
|
||||
print "zsh claude-code plugin: claude not found. Please install Claude Code before using this plugin." >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Configuration variables
|
||||
|
||||
# Default model for clm function (e.g., opus, sonnet, haiku, or full model ID)
|
||||
: ${ZSH_CLAUDE_DEFAULT_MODEL:=}
|
||||
# Default reasoning effort level (low, medium, high, max)
|
||||
: ${ZSH_CLAUDE_DEFAULT_EFFORT:=}
|
||||
# Default permission mode for claude sessions (choices: "acceptEdits", "bypassPermissions", "default", "dontAsk", "plan", "auto")
|
||||
: ${ZSH_CLAUDE_DEFAULT_PERMISSION_MODE:=}
|
||||
# Auto-resume last conversation on new shell start (true/false)
|
||||
: ${ZSH_CLAUDE_AUTO_CONTINUE:=false}
|
||||
|
||||
# Core aliases
|
||||
|
||||
alias cl='_claude_with_defaults'
|
||||
alias clc='_claude_with_defaults --continue'
|
||||
alias clr='_claude_with_defaults --resume'
|
||||
alias clp='_claude_with_defaults -p'
|
||||
alias clv='claude --version'
|
||||
alias clu='claude update'
|
||||
|
||||
# Session aliases
|
||||
|
||||
alias cln='_claude_with_defaults -n'
|
||||
alias clw='_claude_with_defaults -w'
|
||||
alias clfork='_claude_with_defaults --fork-session'
|
||||
|
||||
# Auth aliases
|
||||
|
||||
alias clas='claude auth status'
|
||||
alias clal='claude auth login'
|
||||
alias clao='claude auth logout'
|
||||
|
||||
# Config aliases
|
||||
|
||||
alias clmcp='claude mcp'
|
||||
alias clag='claude agents'
|
||||
|
||||
# Model & effort aliases
|
||||
|
||||
function clm() {
|
||||
local model="${1:-${ZSH_CLAUDE_DEFAULT_MODEL}}"
|
||||
if [[ -z "$model" ]]; then
|
||||
print "Usage: clm <model> (opus, sonnet, haiku, or full model ID)" >&2
|
||||
return 1
|
||||
fi
|
||||
shift 2>/dev/null
|
||||
local -a args=()
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_EFFORT" ]] && args+=(--effort "$ZSH_CLAUDE_DEFAULT_EFFORT")
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE" ]] && args+=(--permission-mode "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE")
|
||||
claude --model "$model" "${args[@]}" "$@"
|
||||
}
|
||||
|
||||
function cle() {
|
||||
local effort="${1:-${ZSH_CLAUDE_DEFAULT_EFFORT}}"
|
||||
if [[ -z "$effort" ]]; then
|
||||
print "Usage: cle <effort> (low, medium, high, max)" >&2
|
||||
return 1
|
||||
fi
|
||||
shift 2>/dev/null
|
||||
local -a args=()
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_MODEL" ]] && args+=(--model "$ZSH_CLAUDE_DEFAULT_MODEL")
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE" ]] && args+=(--permission-mode "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE")
|
||||
claude --effort "$effort" "${args[@]}" "$@"
|
||||
}
|
||||
|
||||
# Channel aliases
|
||||
|
||||
alias clch-tg='_claude_with_defaults --channels plugin:telegram@claude-plugins-official'
|
||||
alias clch-dc='_claude_with_defaults --channels plugin:discord@claude-plugins-official'
|
||||
|
||||
function clch() {
|
||||
if [[ -z "$1" ]]; then
|
||||
print "Usage: clch <channel-spec> [claude-args...]" >&2
|
||||
print " e.g. clch plugin:telegram@claude-plugins-official" >&2
|
||||
return 1
|
||||
fi
|
||||
local channel="$1"
|
||||
shift
|
||||
_claude_with_defaults --channels "$channel" "$@"
|
||||
}
|
||||
|
||||
# Helper functions
|
||||
|
||||
# Directory session: create or resume a session named after the current directory
|
||||
# Similar to tmux's tds alias
|
||||
function clds() {
|
||||
local dir="${PWD##*/}"
|
||||
[[ "$PWD" == "$HOME" ]] && dir="HOME"
|
||||
[[ "$PWD" == "/" ]] && dir="ROOT"
|
||||
_claude_with_defaults --resume "$dir" "$@" 2>/dev/null || _claude_with_defaults -n "$dir" "$@"
|
||||
}
|
||||
|
||||
# Resume from a PR number
|
||||
function clfp() {
|
||||
if [[ -z "$1" ]]; then
|
||||
print "Usage: clfp <pr-number>" >&2
|
||||
return 1
|
||||
fi
|
||||
claude --from-pr "$1"
|
||||
}
|
||||
|
||||
# Start claude with default config variables applied
|
||||
function _claude_with_defaults() {
|
||||
local -a args
|
||||
args=()
|
||||
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_MODEL" ]] && args+=(--model "$ZSH_CLAUDE_DEFAULT_MODEL")
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_EFFORT" ]] && args+=(--effort "$ZSH_CLAUDE_DEFAULT_EFFORT")
|
||||
[[ -n "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE" ]] && args+=(--permission-mode "$ZSH_CLAUDE_DEFAULT_PERMISSION_MODE")
|
||||
|
||||
claude "${args[@]}" "$@"
|
||||
}
|
||||
|
||||
# Tab completion
|
||||
|
||||
function _claude_code_models() {
|
||||
local -a models
|
||||
models=(
|
||||
'opus:Claude Opus (most capable)'
|
||||
'sonnet:Claude Sonnet (balanced)'
|
||||
'haiku:Claude Haiku (fastest)'
|
||||
)
|
||||
_describe 'model' models
|
||||
}
|
||||
|
||||
function _claude_code_efforts() {
|
||||
local -a efforts
|
||||
efforts=(
|
||||
'low:Minimal reasoning'
|
||||
'medium:Balanced reasoning'
|
||||
'high:Deep reasoning'
|
||||
'max:Maximum reasoning depth'
|
||||
)
|
||||
_describe 'effort' efforts
|
||||
}
|
||||
|
||||
function _claude_code_permission_modes() {
|
||||
local -a modes
|
||||
modes=(
|
||||
'plan:Plan mode - confirm before actions'
|
||||
'auto:Auto mode - approve safe actions'
|
||||
'manual:Manual mode - approve everything'
|
||||
)
|
||||
_describe 'permission-mode' modes
|
||||
}
|
||||
|
||||
function _clm() {
|
||||
_arguments '1:model:_claude_code_models' '*::args:'
|
||||
}
|
||||
|
||||
function _cle() {
|
||||
_arguments '1:effort:_claude_code_efforts' '*::args:'
|
||||
}
|
||||
|
||||
compdef _clm clm
|
||||
compdef _cle cle
|
||||
|
||||
# Auto-continue on shell start
|
||||
|
||||
if [[ "$ZSH_CLAUDE_AUTO_CONTINUE" == "true" && -z "$CLAUDECODE" ]]; then
|
||||
claude --continue 2>/dev/null
|
||||
fi
|
||||
Loading…
Add table
Add a link
Reference in a new issue