add proj config command, remove legacy DEV_ROOT, minor help text updates

Author: Kikolator

CHANGELOG.md

@@ -14,6 +14,19 @@ This project follows the [Keep a Changelog](https://keepachangelog.com/) convent
   - `completion.bats`
   - `proj_config_sets_root.bats`
 
+## [0.1.4] - 2025-06-30
+
+### Added
+
+- Sub‑command `proj config <dir>` for setting **PROJ_DEV_ROOT** and persisting it to _~/.zshrc_.
+- Tab‑completion support for the new sub‑command.
+
+### Changed
+
+- Replaced the standalone helper `proj-config` with the new sub‑command.
+- Removed legacy **DEV_ROOT** variable; the plugin now relies solely on **PROJ_DEV_ROOT**.
+- Updated help text, completion logic, and internal code to reflect the single‑variable configuration.
+
 ## [0.1.3] - 2025‑06‑30
 
 ### Added

README.md

@@ -5,7 +5,7 @@
 ```text
 proj listy        # → /Volumes/dog_house/development/projects/listy
 proj              # fuzzy‑pick a project (needs fzf)
-proj-config ~/code # one‑time helper to set a different root
+proj config ~/code # one‑time helper to set a different root
 ```
 
 --------------------------------------------------------------------------------
@@ -16,7 +16,7 @@ proj-config ~/code # one‑time helper to set a different root
 - **One‑word `proj <name>`** – faster than typing long paths.
 - **Interactive picker** – choose from a fuzzy list when you just run `proj` (uses **fzf** if available).
 - **Tab completion** – `proj sa<Tab>` → `proj savage`.
-- **Config helper** – `proj-config /path` adds `export PROJ_DEV_ROOT=/path` to your `.zshrc`.
+- **Config helper** – `proj config /path` adds `export PROJ_DEV_ROOT=/path` to your `.zshrc`.
 
 --------------------------------------------------------------------------------
 
@@ -52,14 +52,13 @@ Jump to a project      | `proj savage`        | `cd` into _savage_
 Pick interactively     | `proj`               | fuzzy list via **fzf**
 List projects (no fzf) | `proj`               | prints directory names
 Tab‑complete           | `proj li<Tab>`       | expands to _listy_
-Set a new root         | `proj-config ~/code` | writes `export PROJ_DEV_ROOT=~/code` to `.zshrc`
+Set a new root         | `proj config ~/code` | writes `export PROJ_DEV_ROOT=~/code` to `.zshrc`
 
 ### Environment variables
 
 Variable        | Purpose
---------------- | ----------------------------------------------------------------------
-`PROJ_DEV_ROOT` | Override the default root (`/Volumes/dog_house/development/projects`).
-`DEV_ROOT`      | Alias kept for compatibility.
+--------------- | ------------------------------------------------
+`PROJ_DEV_ROOT` | Override the default root (`$HOME/development`).
 
 --------------------------------------------------------------------------------
 

_proj

@@ -1,4 +1,4 @@
 #compdef proj
 
 _arguments \
-  '1:project name:_files -W "$DEV_ROOT" -/"*"' && return 0
+  '1:project name:_files -W "$PROJ_DEV_ROOT" -/"*"' && return 0

proj-jumper.plugin.zsh

@@ -1,11 +1,10 @@
 #!/usr/bin/env zsh
 # proj-jumper — jump quickly into a project directory under $DEV_ROOT
-# v0.1.3-dev
+# v0.1.4-dev
 
 # -------- configuration ------
-: ${DEV_ROOT:=${PROJ_DEV_ROOT:-"~/development"}}
-# allow users to export PROJ_DEV_ROOT or DEV_ROOT to override
-export DEV_ROOT
+# A single variable controls the root; fallback is ~/development.
+: ${PROJ_DEV_ROOT:="$HOME/development"}
 
 # ───────── help text ─────────
 _proj_usage() {
@@ -14,20 +13,20 @@ proj-jumper — jump to project directories
 
 Usage:
   proj <name>          cd into the project called <name>
+  proj config <dir>    set PROJ_DEV_ROOT to <dir> and save it in ~/.zshrc
   proj                 interactive picker (fzf if available, else list)
   proj -h | --help     show this help
 
 Options:
   -h, --help           display this help and exit
 
 Environment variables:
-  PROJ_DEV_ROOT        override the default root path ($DEV_ROOT)
-  DEV_ROOT             same as above (kept for compatibility)
+  PROJ_DEV_ROOT        override the default root path ($PROJ_DEV_ROOT)
 
 Examples:
-  proj savage          → cd \$DEV_ROOT/savage
+  proj savage          → cd \$PROJ_DEV_ROOT/savage
   proj                 → fuzzy-select a project
-  proj-config ~/code   → write export PROJ_DEV_ROOT=~/code to ~/.zshrc
+  proj config ~/code   → write export PROJ_DEV_ROOT=~/code to ~/.zshrc
 EOF
 }
 
@@ -37,53 +36,53 @@ proj () {
   # 0. help first
   [[ "$1" == "-h" || "$1" == "--help" ]] && { _proj_usage; return 0 }
 
+  # configure root
+  if [[ "$1" == "config" ]]; then
+    local new_root=$2
+    if [[ -z $new_root ]]; then
+      print -u2 "Usage: proj config /path/to/root"
+      return 1
+    fi
+    [[ -d $new_root ]] || { print -u2 "Directory does not exist: $new_root"; return 1; }
+
+    export PROJ_DEV_ROOT="$new_root"
+    local rcfile=${ZDOTDIR:-$HOME}/.zshrc
+    sed -i '' '/^export PROJ_DEV_ROOT=/d' "$rcfile"
+    echo "export PROJ_DEV_ROOT=$new_root" >>"$rcfile"
+    print "PROJ_DEV_ROOT set to $new_root (added to $rcfile)."
+    print "Restart your shell or run: source $rcfile"
+    return 0
+  fi
+
+  local root="${PROJ_DEV_ROOT:-$HOME/development}"
+
+
   # 1. verify disk
-  [[ -d $DEV_ROOT ]] || { print -u2 "⚠️ $DEV_ROOT not found"; return 1 }
+  [[ -d $root ]] || { print -u2 "⚠️ $root not found"; return 1 }
 
   # 2. arg-aware behaviour
   if [[ -z $1 ]]; then
     # no arg → interactive picker if fzf present, else list
     if command -v fzf >/dev/null; then
       local sel
-      sel=$(command ls -1 "$DEV_ROOT" | fzf --prompt='project> ')
-      [[ -n $sel ]] && cd "$DEV_ROOT/$sel"
+      sel=$(command ls -1 "$root" | fzf --prompt='project> ')
+      [[ -n $sel ]] && cd "$root/$sel"
     else
-      print "Projects:"; command ls "$DEV_ROOT"
+      print "Projects:"; command ls "$root"
     fi
   else
     # arg → direct cd with safety
-    local target="$DEV_ROOT/$1"
+    local target="$root/$1"
     [[ -d $target ]] && cd "$target" || {
       print -u2 "No such project: $1"; return 1
     }
   fi
 }
 
-# ───────── config helper ─────────
-proj-config () {
-  local new_root=${1:-}
-  [[ -z $new_root ]] && {
-    print -u2 "Usage: proj-config /path/to/root"
-    return 1
-  }
-  if [[ ! -d $new_root ]]; then
-    print -u2 "Directory does not exist: $new_root"
-    return 1
-  fi
-
-  local rcfile=${ZDOTDIR:-$HOME}/.zshrc
-  # strip any existing line that sets the var, then append the new one
-  sed -i '' '/^export PROJ_DEV_ROOT=/d' "$rcfile"
-  echo "export PROJ_DEV_ROOT=$new_root" >>"$rcfile"
-  print "PROJ_DEV_ROOT set to $new_root (added to $rcfile)."
-  print "Restart your shell or run: source $rcfile"
-}
-compdef _files proj-config   # tab-complete directories
-
 # ─────── completion helpers ───────
 # Late-bound because the volume could mount after shell start
 _proj_complete () {
-  [[ -d $DEV_ROOT ]] || return
-  compadd -- $(command ls -1 "$DEV_ROOT")
+  local root="${PROJ_DEV_ROOT:-$HOME/development}"
+  [[ -d $root ]] || returncompadd -- $(command ls -1 "$root")
 }
 compdef _proj_complete proj