@quickcall/all-configs 0.0.0-stage → 1.0.0

package/runtime/modules/slack/install.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+step "Installing Slack"
+
+if [[ "$PLATFORM" != "mac" ]]; then
+    warn "Slack module currently supports macOS only"
+    exit 0
+fi
+
+if command -v brew &>/dev/null; then
+    brew_install_cask slack
+else
+    warn "Homebrew not found; skipping Slack app install"
+fi
+
+echo ""
+echo -e "  ${GRN}Done!${R}"
+echo ""

package/runtime/modules/slack/module.toml

@@ -0,0 +1,11 @@
+name = "slack"
+description = "Installs Slack via Homebrew"
+platforms = ["mac"]
+kind = "app"
+
+[detect]
+brew = ["slack"]
+apps = ["Slack"]
+
+[uninstall]
+brew = ["slack"]

package/runtime/modules/spotify/install.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+step "Installing Spotify"
+
+if [[ "$PLATFORM" != "mac" ]]; then
+    warn "Spotify module currently supports macOS only"
+    exit 0
+fi
+
+if command -v brew &>/dev/null; then
+    brew_install_cask spotify
+else
+    warn "Homebrew not found; skipping Spotify app install"
+fi
+
+echo ""
+echo -e "  ${GRN}Done!${R}"
+echo ""

package/runtime/modules/spotify/module.toml

@@ -0,0 +1,11 @@
+name = "spotify"
+description = "Installs Spotify via Homebrew"
+platforms = ["mac"]
+kind = "app"
+
+[detect]
+brew = ["spotify"]
+apps = ["Spotify"]
+
+[uninstall]
+brew = ["spotify"]

package/runtime/modules/ssh-keygen/install.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+usage() {
+  cat << USAGE
+Usage: ${0##*/} [options]
+
+Options:
+  -e, --email <email>        Key email/comment (required)
+  -u, --username <username>  SSH username (default: current user)
+  -H, --hostname <hostname>  Target host (default: github.com)
+  -k, --keyname <name>       Output key filename (default: id_ed25519_<hostname>)
+  -c, --comment <comment>    Key comment (default: <email>)
+  -h, --help                 Show this help
+
+Examples:
+  ${0##*/} -e sagar@example.com -u sagar -H github.com
+USAGE
+  exit 0
+}
+
+EMAIL="${EMAIL:-}"
+USERNAME="${USERNAME:-$(whoami)}"
+# bash presets $HOSTNAME to the machine name, so it cannot carry a default
+TARGET_HOST="${SSH_HOST:-github.com}"
+KEYNAME="${KEYNAME:-}"
+COMMENT="${COMMENT:-}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -e|--email) EMAIL="$2"; shift 2 ;;
+    -u|--username) USERNAME="$2"; shift 2 ;;
+    -H|--hostname) TARGET_HOST="$2"; shift 2 ;;
+    -k|--keyname) KEYNAME="$2"; shift 2 ;;
+    -c|--comment) COMMENT="$2"; shift 2 ;;
+    -h|--help) usage ;;
+    *) fail "Unknown option: $1"; exit 1 ;;
+  esac
+done
+
+if [[ -z "$EMAIL" && -t 0 ]]; then
+  read -rp "  Email for SSH key comment: " EMAIL
+fi
+[[ -n "$EMAIL" ]] || { fail "--email is required (or set EMAIL)"; exit 1; }
+
+if [[ -z "$KEYNAME" ]]; then
+  # strip domain suffix, e.g. github.com -> github
+  KEYNAME="id_ed25519_${TARGET_HOST%%.*}"
+fi
+[[ -n "$COMMENT" ]] || COMMENT="$EMAIL"
+
+KEY_PATH="$HOME/.ssh/$KEYNAME"
+SSH_DIR="$HOME/.ssh"
+CONFIG_FILE="$SSH_DIR/config"
+
+step "Generating SSH key"
+
+mkdir -p "$SSH_DIR"
+chmod 700 "$SSH_DIR"
+
+if [[ -f "$KEY_PATH" ]]; then
+  warn "key already exists: $KEY_PATH"
+else
+  ssh-keygen -t ed25519 -C "$COMMENT" -f "$KEY_PATH" -N ""
+  ok "key generated: $KEY_PATH"
+fi
+
+chmod 600 "$KEY_PATH"
+chmod 644 "$KEY_PATH.pub"
+
+step "Adding key to ssh-agent"
+
+if command -v ssh-agent &>/dev/null && [[ -n "${SSH_AGENT_PID:-}" ]]; then
+  ssh-add "$KEY_PATH" 2>/dev/null && ok "key added to ssh-agent" || warn "ssh-add failed"
+else
+  warn "ssh-agent not running — skipping ssh-add"
+fi
+
+step "Updating SSH config"
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  touch "$CONFIG_FILE"
+  chmod 600 "$CONFIG_FILE"
+fi
+
+HOST_ALIAS="$TARGET_HOST"
+
+# Remove existing block for this host if present
+if grep -q "# ssh-keygen: $HOST_ALIAS" "$CONFIG_FILE" 2>/dev/null; then
+  # portable in-place delete (BSD sed -i needs a suffix arg, GNU does not)
+  tmp="$(mktemp)"
+  sed "/# ssh-keygen: $HOST_ALIAS/,/# end ssh-keygen: $HOST_ALIAS/d" "$CONFIG_FILE" > "$tmp"
+  cat "$tmp" > "$CONFIG_FILE" && rm -f "$tmp"
+fi
+
+cat >> "$CONFIG_FILE" << EOF
+# ssh-keygen: $HOST_ALIAS
+Host $HOST_ALIAS
+    HostName $TARGET_HOST
+    User $USERNAME
+    IdentityFile $KEY_PATH
+    IdentitiesOnly yes
+# end ssh-keygen: $HOST_ALIAS
+EOF
+
+ok "SSH config updated: $CONFIG_FILE"
+
+step "Testing GitHub SSH authentication"
+
+if [[ "$TARGET_HOST" == "github.com" ]]; then
+  if ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o ConnectTimeout=10 -i "$KEY_PATH" -T git@github.com 2>&1 | grep -q "successfully authenticated"; then
+    ok "GitHub SSH authentication works"
+  else
+    warn "GitHub SSH authentication failed — add the public key to GitHub first"
+  fi
+else
+  warn "hostname is not github.com — skipping GitHub auth test"
+fi
+
+echo ""
+echo -e "  ${GRN}Done!${R} Public key: ${CYN}$KEY_PATH.pub${R}"
+echo ""
+echo -e "  ${D}Add this to $TARGET_HOST:${R}"
+echo ""
+cat "$KEY_PATH.pub"
+echo ""

package/runtime/modules/ssh-keygen/module.toml

@@ -0,0 +1,4 @@
+name = "ssh-keygen"
+description = "Generate SSH keys, update config, and test GitHub auth"
+platforms = ["mac", "linux"]
+kind = "config"

package/runtime/modules/statusline/install.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+source "$ROOT_DIR/lib/common.sh"
+
+CLAUDE_DIR="$HOME/.claude"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+
+step "Installing statusline"
+
+# Check jq
+if ! command -v jq &>/dev/null; then
+    fail "jq required — brew install jq / apt install jq"
+    exit 1
+fi
+
+mkdir -p "$CLAUDE_DIR"
+
+# Copy files
+cp "$SCRIPT_DIR/statusline.sh" "$CLAUDE_DIR/statusline-command.sh"
+chmod +x "$CLAUDE_DIR/statusline-command.sh"
+ok "statusline.sh ${D}→ ~/.claude/${R}"
+
+cp "$SCRIPT_DIR/turn-counter.sh" "$CLAUDE_DIR/turn-counter.sh"
+chmod +x "$CLAUDE_DIR/turn-counter.sh"
+ok "turn-counter.sh ${D}→ ~/.claude/${R}"
+
+# Merge into settings.json
+if [[ -f "$SETTINGS_FILE" ]]; then
+    cp "$SETTINGS_FILE" "$CLAUDE_DIR/settings.json.bak"
+    existing=$(cat "$SETTINGS_FILE")
+else
+    existing="{}"
+fi
+
+updated=$(echo "$existing" | jq '
+  .statusLine = {
+    "type": "command",
+    "command": ($home + "/.claude/statusline-command.sh")
+  } |
+  .hooks.Stop = (
+    [(.hooks.Stop // [])[] | select(.hooks[0].command | test("turn-counter\\.sh$") | not)] +
+    [{"hooks": [{"type": "command", "command": ($home + "/.claude/turn-counter.sh")}]}]
+  )
+' --arg home "$HOME")
+
+echo "$updated" > "$SETTINGS_FILE"
+ok "settings.json ${D}(merged)${R}"
+
+# Verify
+all_good=true
+[[ -x "$CLAUDE_DIR/statusline-command.sh" ]] || all_good=false
+[[ -x "$CLAUDE_DIR/turn-counter.sh" ]] || all_good=false
+settings_ok=$(jq 'has("statusLine") and has("hooks")' "$SETTINGS_FILE" 2>/dev/null)
+[[ "$settings_ok" == "true" ]] || all_good=false
+
+if [[ "$all_good" == true ]]; then
+    ok "all checks passed"
+else
+    warn "installed with issues"
+fi
+
+echo ""
+echo -e "  ${D}preview:${R}  ${BLU}my-project${R}${D}/${R}${GRN}main${R}  ${D}session${R} ${GRN} 2%${R} ${D}4h 50m${R}  ${D}ctx${R} ${GRN}5%${R}  ${D}T#${R}${CYN}3${R}"
+echo -e "          ${MAG}opus[1M]${R}       ${D}weekly${R}  ${YLW}60%${R} ${D}2d 15h${R}  ${GRN}o low${R}"
+echo -e "  ${D}restart claude code to activate${R}"
+echo ""

package/runtime/modules/statusline/module.toml

@@ -0,0 +1,7 @@
+name = "statusline"
+description = "Status bar + turn counter for Claude Code"
+platforms = ["mac", "linux"]
+kind = "config"
+
+[detect]
+paths = ["~/.claude/statusline-command.sh"]

package/runtime/modules/statusline/statusline.sh

@@ -0,0 +1,168 @@
+#!/usr/bin/env bash
+
+input=$(cat)
+
+eval "$(echo "$input" | jq -r '
+  @sh "cwd=\(.workspace.current_dir // .cwd)",
+  @sh "model=\(.model.display_name // "Claude")",
+  @sh "used_pct=\(.context_window.used_percentage // 0)",
+  @sh "total_input=\(.context_window.total_input_tokens // 0)",
+  @sh "total_output=\(.context_window.total_output_tokens // 0)",
+  @sh "ctx_window_size=\(.context_window.context_window_size // 0)",
+  @sh "session_id=\(.session_id // "")",
+  @sh "session_name=\(.session_name // "")",
+  @sh "five_h_pct=\(.rate_limits.five_hour.used_percentage // "")",
+  @sh "five_h_reset=\(.rate_limits.five_hour.resets_at // "")",
+  @sh "seven_d_pct=\(.rate_limits.seven_day.used_percentage // "")",
+  @sh "seven_d_reset=\(.rate_limits.seven_day.resets_at // "")"
+')"
+
+R='\033[0m'; B='\033[1m'; D='\033[2m'
+BLUE='\033[38;5;33m'
+GREEN='\033[38;5;34m'
+YELLOW='\033[38;5;172m'
+RED='\033[38;5;160m'
+CYAN='\033[38;5;31m'
+MAGENTA='\033[38;5;92m'
+GRAY='\033[38;5;244m'
+DIM='\033[38;5;240m'
+
+# ── Git ───────────────────────────────────────────────────────────────────────
+git_root="" git_branch=""
+if git -C "$cwd" rev-parse --git-dir >/dev/null 2>&1; then
+    git_root=$(basename "$(git -C "$cwd" --no-optional-locks rev-parse --show-toplevel 2>/dev/null)")
+    git_branch=$(git -C "$cwd" --no-optional-locks branch --show-current 2>/dev/null)
+    [[ -z "$git_branch" ]] && git_branch=$(git -C "$cwd" --no-optional-locks rev-parse --short HEAD 2>/dev/null)
+    if ! git -C "$cwd" --no-optional-locks diff-index --quiet HEAD -- 2>/dev/null; then
+        git_branch="${git_branch}*"
+    fi
+fi
+dir="${git_root:-$(basename "$cwd")}"
+
+# ── Model short ──────────────────────────────────────────────────────────────
+short_model=$(echo "$model" | sed -E 's/Claude //; s/ \(.*//')
+short_model="${short_model,}"
+if [[ $ctx_window_size -ge 1000000 ]]; then
+    short_model+="[$(( ctx_window_size / 1000000 ))M]"
+elif [[ $ctx_window_size -ge 1000 ]]; then
+    short_model+="[$(( ctx_window_size / 1000 ))K]"
+fi
+
+# ── Context % ────────────────────────────────────────────────────────────────
+used_int=${used_pct%.*}; used_int=${used_int:-0}
+if   [[ $used_int -lt 50 ]]; then cc="$GREEN"
+elif [[ $used_int -lt 75 ]]; then cc="$YELLOW"
+else cc="$RED"; fi
+
+# ── Turn ─────────────────────────────────────────────────────────────────────
+turn="0"
+if [[ -n "$session_id" ]]; then
+    tf="/tmp/claude-turns-${session_id}.txt"
+    [[ -f "$tf" ]] && turn=$(cat "$tf" 2>/dev/null)
+fi
+[[ -z "$turn" ]] && turn="0"
+
+# ── Countdown ────────────────────────────────────────────────────────────────
+fmt_cd() {
+    local diff=$(( $1 - $(date +%s) ))
+    if [[ $diff -le 0 ]]; then echo "now"
+    elif [[ $diff -ge 86400 ]]; then printf "%dd %dh" $(( diff/86400 )) $(( (diff%86400)/3600 ))
+    elif [[ $diff -ge 3600 ]]; then printf "%dh %dm" $(( diff/3600 )) $(( (diff%3600)/60 ))
+    else printf "%dm" $(( diff/60 )); fi
+}
+
+lc() {
+    if   [[ $1 -lt 50 ]]; then echo "$GREEN"
+    elif [[ $1 -lt 80 ]]; then echo "$YELLOW"
+    else echo "$RED"; fi
+}
+
+# ── Rate limits (aligned sub-fields) ─────────────────────────────────────────
+s_label="session"; s_pct=""; s_time=""; sc=""
+if [[ -n "$five_h_pct" ]]; then
+    sv=$(printf "%.0f" "$five_h_pct"); sc=$(lc "$sv")
+    s_pct="${sv}%"
+    [[ -n "$five_h_reset" ]] && s_time=$(fmt_cd "$five_h_reset")
+fi
+
+w_label="weekly"; w_pct=""; w_time=""; wc=""
+if [[ -n "$seven_d_pct" ]]; then
+    wv=$(printf "%.0f" "$seven_d_pct"); wc=$(lc "$wv")
+    w_pct="${wv}%"
+    [[ -n "$seven_d_reset" ]] && w_time=$(fmt_cd "$seven_d_reset")
+fi
+
+lw=$(( ${#s_label} > ${#w_label} ? ${#s_label} : ${#w_label} ))
+pw=$(( ${#s_pct}   > ${#w_pct}   ? ${#s_pct}   : ${#w_pct}   ))
+tw=$(( ${#s_time}  > ${#w_time}  ? ${#s_time}  : ${#w_time}  ))
+
+session_bit=""
+if [[ -n "$s_pct" ]]; then
+    session_bit=$(printf "%b%-*s%b %b%b%*s%b %b%*s%b" \
+        "$GRAY" "$lw" "$s_label" "$R" \
+        "$sc" "$B" "$pw" "$s_pct" "$R" \
+        "$DIM" "$tw" "$s_time" "$R")
+fi
+
+weekly_bit=""
+if [[ -n "$w_pct" ]]; then
+    weekly_bit=$(printf "%b%-*s%b %b%b%*s%b %b%*s%b" \
+        "$GRAY" "$lw" "$w_label" "$R" \
+        "$wc" "$B" "$pw" "$w_pct" "$R" \
+        "$DIM" "$tw" "$w_time" "$R")
+fi
+
+# ── Right side ───────────────────────────────────────────────────────────────
+right=""
+[[ -n "$session_name" ]] && right="${GRAY}[s] ${session_name}${R}"
+
+# ── Effort level (read from settings) ────────────────────────────────────────
+effort=$(jq -r '.effortLevel // "medium"' ~/.claude/settings.json 2>/dev/null)
+case "$effort" in
+    low)  effort_display="${GREEN}o low${R}" ;;
+    high) effort_display="${RED}* high${R}" ;;
+    *)    effort_display="${YELLOW}~ med${R}" ;;
+esac
+
+# ── Line 1: identity + turn + effort ────────────────────────────────────────
+# ── Column helpers (visible length, strip ANSI) ─────────────────────────────
+vlen() {
+    local s=$1
+    s=$(printf '%b' "$s" | sed 's/\x1b\[[0-9;]*m//g')
+    echo -n "${#s}"
+}
+pad() {
+    local s=$1 w=$2
+    local l; l=$(vlen "$s")
+    local n=$(( w - l ))
+    [[ $n -lt 0 ]] && n=0
+    printf '%b%*s' "$s" "$n" ''
+}
+mx() { [[ $1 -gt $2 ]] && echo "$1" || echo "$2"; }
+
+# ── Build columns ────────────────────────────────────────────────────────────
+c1a="${BLUE}${B}${dir}${R}${GRAY}/${R}${GREEN}${git_branch}${R}"
+c1b="${MAGENTA}${short_model}${R}"
+
+c2a="$session_bit"
+c2b="$weekly_bit"
+
+c3a="${GRAY}ctx${R} ${cc}${B}${used_int}%${R}"
+c3b="$effort_display"
+
+c4a="${GRAY}T#${R}${CYAN}${B}${turn}${R}"
+c4b=""
+
+c5a="$right"
+c5b=""
+
+w1=$(mx "$(vlen "$c1a")" "$(vlen "$c1b")")
+w2=$(mx "$(vlen "$c2a")" "$(vlen "$c2b")")
+w3=$(mx "$(vlen "$c3a")" "$(vlen "$c3b")")
+w4=$(mx "$(vlen "$c4a")" "$(vlen "$c4b")")
+
+SEP="  "
+line1="$(pad "$c1a" "$w1")${SEP}$(pad "$c2a" "$w2")${SEP}$(pad "$c3a" "$w3")${SEP}$(pad "$c4a" "$w4")${SEP}${c5a}"
+line2="$(pad "$c1b" "$w1")${SEP}$(pad "$c2b" "$w2")${SEP}$(pad "$c3b" "$w3")${SEP}$(pad "$c4b" "$w4")${SEP}${c5b}"
+
+printf '%b\n%b' "$line1" "$line2"

package/runtime/modules/statusline/turn-counter.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Increment turn counter per session
+# Counter lives at /tmp/claude-turns-<session_id>.txt
+# Resumed sessions (claude --resume) keep the same session_id,
+# so the counter picks up where it left off.
+# Files in /tmp survive until reboot.
+INPUT=$(cat)
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id')
+TURN_FILE="/tmp/claude-turns-${SESSION_ID}.txt"
+CURRENT=$(cat "$TURN_FILE" 2>/dev/null || echo "0")
+echo $(( CURRENT + 1 )) > "$TURN_FILE"

package/runtime/modules/superfile/cheatsheet.md

@@ -0,0 +1,127 @@
+# Superfile (spf) Cheat Sheet
+
+Your current setup. macOS config: `~/Library/Application Support/superfile/`
+(hotkeys: `hotkeys.toml`, settings: `config.toml`)
+
+Launch: `spf` · Quit: `q` or `esc` · Help in app: `?`
+
+---
+
+## Moving Around
+
+| Key | Action |
+|---|---|
+| `j` / `k` or ↓ / ↑ | move cursor down / up |
+| `h` or ← or `backspace` | parent directory |
+| `enter` / `l` / → | open file or folder |
+| `pgup` / `pgdn` | page up / down |
+| `/` | search current directory (type to filter) |
+| `z` | zoxide jump — global smart dir jump |
+| `.` | show / hide dotfiles |
+| `o` | sort menu (name / size / date) |
+| `R` | reverse sort order |
+
+## Panels (split views)
+
+| Key | Action |
+|---|---|
+| `ctrl+n` | new file panel |
+| `w` | close current panel |
+| `tab` / `L` | next panel |
+| `shift+left` / `H` | previous panel |
+| `N` | split panel |
+
+## Focus Other Areas
+
+| Key | Action |
+|---|---|
+| `s` | sidebar (pinned dirs) — press again to go back |
+| `m` | metadata panel |
+| `p` | process bar (copy progress etc.) |
+| `f` | toggle file preview |
+| `F` | toggle footer panels |
+| `P` | pin / unpin current folder to sidebar |
+
+## File Operations
+
+Works on file under cursor, or all selected files in select mode.
+
+| Key | Action |
+|---|---|
+| `n` | **new file** (add `/` at end of name = new folder) |
+| `ctrl+r` | rename |
+| `ctrl+c` | copy |
+| `ctrl+x` | cut |
+| `ctrl+v` | paste |
+| `ctrl+d` / `delete` | delete → Trash |
+| `D` | delete permanently (NO undo) |
+| `ctrl+a` | compress (zip) |
+| `ctrl+e` | extract archive |
+
+> Copy/cut items show in **clipboard panel** (bottom right).
+> Progress shows in **process panel** (bottom left).
+
+## Select Mode (bulk ops — like vim visual mode)
+
+| Key | Action |
+|---|---|
+| `v` | enter / exit select mode |
+| `enter` / `L` | select / deselect item under cursor |
+| `J` / `shift+↓` | select while moving down |
+| `K` / `shift+↑` | select while moving up |
+| `A` | select all in directory |
+
+Then use file ops above (`ctrl+c`, `ctrl+d`, ...) on the selection.
+
+## Editor (nvim)
+
+| Key | Action |
+|---|---|
+| `e` | open file in nvim |
+| `E` | open current directory in nvim |
+
+## Command Bars
+
+| Key | Action |
+|---|---|
+| `:` | **shell mode** — run any terminal command in current dir (`:git status`) |
+| `>` | spf mode — `cd <PATH>`, `open <PATH>`, `split`; supports `~`, `${VAR}`, `$(cmd)` |
+| `esc` / `ctrl+c` | close the bar |
+
+## Misc
+
+| Key | Action |
+|---|---|
+| `ctrl+p` | copy file path to clipboard |
+| `c` | copy current directory path |
+| `Q` | quit AND cd shell to this dir |
+| `?` | full hotkey list in app |
+
+---
+
+## Common Workflows
+
+**Copy files between two folders (no commands):**
+1. `ctrl+n` new panel → go to destination
+2. `tab` back → select files (`v` + `J`)
+3. `ctrl+c` → `tab` → `ctrl+v`
+
+**Delete several files:**
+`v` → move `j` (auto-marks) or `J` to extend → `ctrl+d`
+
+**Jump to a project, edit it:**
+`z` → type project name → `enter` → `E` (nvim opens dir)
+
+**New folder:**
+`n` → type `myfolder/` → `enter`
+
+**Run a quick command:**
+`:make test` or `:git status` → `esc`
+
+## Shell Setup Notes
+
+- `zoxide` installed + enabled (`zoxide_support = true`). It learns dirs
+  as you `cd` in terminal. Seed it: `z add ~/projects ~/Downloads`
+- Editor = `$EDITOR` = `nvim` (already set)
+- Trash delete needs terminal Full Disk Access:
+  System Settings → Privacy & Security → Full Disk Access → enable your terminal