@alanbem/dclaude 0.0.11 → 0.0.12

package/README.md

@@ -151,6 +151,21 @@ dclaude chrome                    # Launch Chrome with DevTools
 dclaude                           # Claude can now interact with the browser
 ```
 
+### iTerm2 Shell Integration
+
+If you use iTerm2 on macOS, dclaude automatically enables [iTerm2 Shell Integration](https://iterm2.com/documentation-shell-integration.html):
+
+- **Click URLs in output** - Opens in your Mac's browser
+- **imgcat** - Display images inline in terminal
+- **it2copy** - Copy to Mac clipboard from inside container
+- **Marks** - Navigate between command prompts
+
+This only activates when running in iTerm2. To disable:
+
+```bash
+DCLAUDE_ITERM2=false dclaude
+```
+
 ### System Context
 
 dclaude automatically tells Claude about its container environment so it can give better suggestions:
@@ -175,10 +190,12 @@ DCLAUDE_SYSTEM_CONTEXT=false dclaude
 | `DCLAUDE_NAMESPACE` | (none) | Namespace for isolated credentials/config |
 | `DCLAUDE_NETWORK` | `auto` | Network mode: `auto`, `host`, `bridge` |
 | `DCLAUDE_GIT_AUTH` | `auto` | SSH auth: `auto`, `agent-forwarding`, `key-mount`, `none` |
+| `DCLAUDE_MOUNT_ROOT` | (working dir) | Mount parent directory for sibling access |
 | `DCLAUDE_DEBUG` | `false` | Enable debug output |
 | `DCLAUDE_QUIET` | `false` | Suppress info messages |
 | `DCLAUDE_NO_UPDATE` | `false` | Skip image update check |
 | `DCLAUDE_SYSTEM_CONTEXT` | `true` | Inform Claude about container environment |
+| `DCLAUDE_ITERM2` | `true` | Enable iTerm2 shell integration (only affects iTerm2) |
 
 ## Configuration File
 
@@ -200,6 +217,7 @@ dclaude walks up the directory tree to find `.dclaude` files. Any dclaude sessio
 | `NAMESPACE` | Isolate credentials/config (see Namespace Isolation) |
 | `NETWORK` | Network mode (`host`, `bridge`) |
 | `GIT_AUTH` | Git auth mode |
+| `MOUNT_ROOT` | Mount directory (relative to config file, or absolute path) |
 | `DEBUG` | Enable debug output (`true`, `false`) |
 | `CHROME_PORT` | Chrome DevTools port |
 
@@ -238,6 +256,41 @@ Each namespace gets its own:
 - Git configuration
 - Container instance
 
+## Mount Root (Parent Directory Access)
+
+By default, dclaude only mounts the current working directory. Use `MOUNT_ROOT` to mount a parent directory, enabling access to sibling directories.
+
+**Use case:** You're working in a subdirectory but need access to related projects:
+
+```text
+/Users/alan/projects/mycompany/
+├── shared-libs/          # Common libraries
+├── api-service/          # API backend
+├── web-app/              # Frontend
+└── infrastructure/
+    └── terraform/        # ← You're here, but need access to siblings
+```
+
+**Option 1: Using `.dclaude` file (recommended)**
+```bash
+# Create config at the directory you want as mount root
+echo "MOUNT_ROOT=." > ~/projects/mycompany/.dclaude
+
+# Relative paths are resolved from config file's directory
+echo "MOUNT_ROOT=.." > ~/projects/mycompany/subdir/.dclaude  # mounts mycompany/
+```
+
+**Option 2: Using environment variable**
+```bash
+# Relative path (from working directory)
+DCLAUDE_MOUNT_ROOT=../.. dclaude
+
+# Absolute path
+DCLAUDE_MOUNT_ROOT=/Users/alan/projects/mycompany dclaude
+```
+
+Now Claude can see and work with all sibling directories while your working directory remains `terraform/`.
+
 ## Networking
 
 dclaude auto-detects the best networking mode:

package/dclaude

@@ -27,6 +27,7 @@ CHROME_FLAGS="${DCLAUDE_CHROME_FLAGS:-}"
 # - DCLAUDE_GIT_AUTH (git auth mode)
 # - DCLAUDE_DEBUG (enable debug output)
 # - DCLAUDE_CHROME_PORT (chrome devtools port)
+# - DCLAUDE_MOUNT_ROOT (mount a parent directory instead of working directory)
 
 # Colors for output (only if terminal supports it)
 if [[ -t 1 ]]; then
@@ -122,6 +123,18 @@ load_config_file() {
                 CHROME_PORT)
                     [[ -z "${DCLAUDE_CHROME_PORT:-}" ]] && DCLAUDE_CHROME_PORT="$value"
                     ;;
+                MOUNT_ROOT)
+                    if [[ -z "${DCLAUDE_MOUNT_ROOT:-}" ]]; then
+                        # Resolve relative paths relative to config file's directory
+                        if [[ "$value" != /* ]]; then
+                            local config_dir
+                            config_dir=$(dirname "$config_file")
+                            DCLAUDE_MOUNT_ROOT=$(cd "$config_dir" && cd "$value" 2>/dev/null && pwd)
+                        else
+                            DCLAUDE_MOUNT_ROOT="$value"
+                        fi
+                    fi
+                    ;;
             esac
         fi
     done < "$config_file"
@@ -147,6 +160,7 @@ if [[ -n "$DCLAUDE_CONFIG_FILE" ]]; then
         [[ -n "${DCLAUDE_NETWORK:-}" ]] && debug "  NETWORK=$DCLAUDE_NETWORK"
         [[ -n "${DCLAUDE_GIT_AUTH:-}" ]] && debug "  GIT_AUTH=$DCLAUDE_GIT_AUTH"
         [[ -n "${DCLAUDE_CHROME_PORT:-}" ]] && debug "  CHROME_PORT=$DCLAUDE_CHROME_PORT"
+        [[ -n "${DCLAUDE_MOUNT_ROOT:-}" ]] && debug "  MOUNT_ROOT=$DCLAUDE_MOUNT_ROOT"
     fi
 fi
 
@@ -577,6 +591,55 @@ get_host_path() {
     echo "$host_path"
 }
 
+# Compute mount root path from DCLAUDE_MOUNT_ROOT
+# Supports: absolute paths, relative paths (../, ../../, etc.)
+# Returns: Absolute path to mount root, or HOST_PATH if not set
+get_mount_root() {
+    local host_path="$1"
+    local mount_root="${DCLAUDE_MOUNT_ROOT:-}"
+
+    # If not set, use host path (current behavior)
+    if [[ -z "$mount_root" ]]; then
+        echo "$host_path"
+        return 0
+    fi
+
+    local resolved_root
+
+    # Handle relative paths (resolve relative to host_path)
+    if [[ "$mount_root" != /* ]]; then
+        # Relative path - resolve it
+        resolved_root=$(cd "$host_path" && cd "$mount_root" 2>/dev/null && pwd) || {
+            error "Mount root path not accessible: $mount_root (relative to $host_path)"
+            exit 1
+        }
+    else
+        # Absolute path - use directly
+        resolved_root="$mount_root"
+    fi
+
+    # Validate mount root exists
+    if [[ ! -d "$resolved_root" ]]; then
+        error "Mount root directory does not exist: $resolved_root"
+        exit 1
+    fi
+
+    # Validate that host_path is under mount_root
+    # Use realpath to normalize paths for comparison
+    local real_host real_root
+    real_host=$(cd "$host_path" && pwd -P)
+    real_root=$(cd "$resolved_root" && pwd -P)
+
+    if [[ "$real_host" != "$real_root" && "$real_host" != "$real_root"/* ]]; then
+        error "Working directory is not under mount root"
+        error "  Working directory: $real_host"
+        error "  Mount root: $real_root"
+        exit 1
+    fi
+
+    echo "$resolved_root"
+}
+
 # Generate deterministic container name from path (and namespace if set)
 get_container_name() {
     local path="${1:-$HOST_PATH}"
@@ -976,6 +1039,9 @@ main() {
 
     info "Verifying environment..."
     debug "Host path: $HOST_PATH"
+    if [[ "$MOUNT_ROOT" != "$HOST_PATH" ]]; then
+        debug "Mount root: $MOUNT_ROOT"
+    fi
 
     # Check prerequisites
     check_docker
@@ -1108,6 +1174,9 @@ main() {
         debug "  SYSTEM_CONTEXT=$ENABLE_SYSTEM_CONTEXT"
         debug "  IMAGE=$IMAGE"
         debug "  HOST_PATH=$HOST_PATH"
+        if [[ "$MOUNT_ROOT" != "$HOST_PATH" ]]; then
+            debug "  MOUNT_ROOT=$MOUNT_ROOT"
+        fi
         debug "  PLATFORM=$platform"
     fi
 
@@ -1145,6 +1214,16 @@ main() {
                 done
             fi
 
+            # Ensure SSH proxy is running if container uses agent forwarding (macOS)
+            if [[ "$platform" == "darwin" ]]; then
+                local container_ssh_sock
+                container_ssh_sock=$(docker inspect --format='{{range .Config.Env}}{{println .}}{{end}}' "$container_name" 2>/dev/null | grep "^SSH_AUTH_SOCK=" | cut -d= -f2)
+                if [[ "$container_ssh_sock" == "/tmp/ssh-proxy/agent" ]]; then
+                    debug "Container uses SSH agent forwarding, ensuring proxy is running"
+                    setup_ssh_proxy_container
+                fi
+            fi
+
             # Check if interactive (TTY available) and not in print mode
             if [[ -n "$tty_flags" ]] && ! should_skip_tmux "${claude_args[@]}" "$@"; then
                 # Interactive and not print mode - use tmux for session management
@@ -1163,6 +1242,7 @@ main() {
                 [[ -n "${TERM_PROGRAM_VERSION:-}" ]] && exec_env_args+=(-e "TERM_PROGRAM_VERSION=${TERM_PROGRAM_VERSION}")
                 [[ -n "${TERM_SESSION_ID:-}" ]] && exec_env_args+=(-e "TERM_SESSION_ID=${TERM_SESSION_ID}")
                 [[ -n "${COLORTERM:-}" ]] && exec_env_args+=(-e "COLORTERM=${COLORTERM}")
+                [[ -n "${DCLAUDE_ITERM2:-}" ]] && exec_env_args+=(-e "DCLAUDE_ITERM2=${DCLAUDE_ITERM2}")
 
                 debug "Creating new tmux session running Claude"
                 debug "Claude args count: ${#claude_args[@]}, user args: $*"
@@ -1200,11 +1280,11 @@ main() {
     claude_volume=$(get_volume_name)
 
     DOCKER_ARGS+=(
-        # Mount current directory
-        -v "${HOST_PATH}:${HOST_PATH}"
+        # Mount directory tree (mount root allows access to parent directories)
+        -v "${MOUNT_ROOT}:${MOUNT_ROOT}"
         # Mount persistent Claude configuration volume
         -v "${claude_volume}:/home/claude/.claude"
-        # Set working directory
+        # Set working directory (within the mounted tree)
         -w "${HOST_PATH}"
         # Network mode
         --network="$network_mode"
@@ -1240,6 +1320,11 @@ main() {
         DOCKER_ARGS+=(-e "COLORTERM=${COLORTERM}")
     fi
 
+    # Pass through iTerm2 integration opt-out if set
+    if [[ -n "${DCLAUDE_ITERM2:-}" ]]; then
+        DOCKER_ARGS+=(-e "DCLAUDE_ITERM2=${DCLAUDE_ITERM2}")
+    fi
+
     # Mount Docker socket if detected (detection done earlier for system context)
     if [[ -n "$DOCKER_SOCKET" ]] && [[ -S "$DOCKER_SOCKET" ]]; then
         DOCKER_ARGS+=(-v "${DOCKER_SOCKET}:/var/run/docker.sock")
@@ -1310,6 +1395,7 @@ main() {
             [[ -n "${TERM_PROGRAM_VERSION:-}" ]] && exec_env_args+=(-e "TERM_PROGRAM_VERSION=${TERM_PROGRAM_VERSION}")
             [[ -n "${TERM_SESSION_ID:-}" ]] && exec_env_args+=(-e "TERM_SESSION_ID=${TERM_SESSION_ID}")
             [[ -n "${COLORTERM:-}" ]] && exec_env_args+=(-e "COLORTERM=${COLORTERM}")
+            [[ -n "${DCLAUDE_ITERM2:-}" ]] && exec_env_args+=(-e "DCLAUDE_ITERM2=${DCLAUDE_ITERM2}")
 
             debug "Creating new tmux session running Claude"
             debug "Claude args count: ${#claude_args[@]}, user args: $*"
@@ -1458,6 +1544,7 @@ cmd_attach() {
     [[ -n "${TERM_PROGRAM_VERSION:-}" ]] && exec_env_args+=(-e "TERM_PROGRAM_VERSION=${TERM_PROGRAM_VERSION}")
     [[ -n "${TERM_SESSION_ID:-}" ]] && exec_env_args+=(-e "TERM_SESSION_ID=${TERM_SESSION_ID}")
     [[ -n "${COLORTERM:-}" ]] && exec_env_args+=(-e "COLORTERM=${COLORTERM}")
+    [[ -n "${DCLAUDE_ITERM2:-}" ]] && exec_env_args+=(-e "DCLAUDE_ITERM2=${DCLAUDE_ITERM2}")
 
     # Attach to existing session
     info "Attaching to session: $session_name"
@@ -1514,7 +1601,7 @@ cmd_chrome() {
     fi
 
     # 2. Setup profile directory
-    local profile_dir="$HOST_PATH/.dclaude/chrome/profiles/$CHROME_PROFILE"
+    local profile_dir="$HOST_PATH/.dclaude.d/chrome/profiles/$CHROME_PROFILE"
     mkdir -p "$profile_dir"
     debug "Profile directory: $profile_dir"
 
@@ -1989,8 +2076,9 @@ cmd_git() {
     exit 0
 }
 
-# Initialize HOST_PATH once for all commands
+# Initialize HOST_PATH and MOUNT_ROOT once for all commands
 HOST_PATH=$(get_host_path)
+MOUNT_ROOT=$(get_mount_root "$HOST_PATH")
 
 # Handle subcommands
 if [[ $# -gt 0 ]]; then
@@ -2067,6 +2155,7 @@ Environment Variables:
   DCLAUDE_NAMESPACE          Namespace for isolated credentials/config
   DCLAUDE_GIT_AUTH           SSH auth for Git: auto, agent-forwarding, key-mount, none
   DCLAUDE_NETWORK            Network mode: auto, host, bridge
+  DCLAUDE_MOUNT_ROOT         Mount parent directory (absolute or relative path)
   DCLAUDE_DOCKER_SOCKET      Override Docker socket path
   DCLAUDE_TMUX_SESSION       Custom tmux session name (default: claude-TIMESTAMP)
   DCLAUDE_CHROME_BIN         Chrome executable path (auto-detected if not set)
@@ -2079,6 +2168,8 @@ Configuration File (.dclaude):
     NAMESPACE=mycompany
     NETWORK=host
     DEBUG=true
+    MOUNT_ROOT=.           # Mount config file's directory
+    MOUNT_ROOT=..          # Mount parent of config file's directory
   dclaude walks up the directory tree to find .dclaude files.
   Environment variables override .dclaude settings.
 
@@ -2102,6 +2193,11 @@ Examples:
   DCLAUDE_NAMESPACE=mycompany dclaude
   # Or create .dclaude file: echo "NAMESPACE=mycompany" > ~/projects/mycompany/.dclaude
 
+  # Mount parent directory to access sibling directories
+  DCLAUDE_MOUNT_ROOT=.. dclaude                    # Relative path
+  DCLAUDE_MOUNT_ROOT=/Users/alan/projects dclaude  # Absolute path
+  # Or in .dclaude file: MOUNT_ROOT=..
+
   # Update image and restart container
   dclaude pull                                   # Pull latest image
   dclaude update                                 # Update Claude CLI in container

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanbem/dclaude",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Dockerized Claude Code CLI launcher with MCP support",
   "main": "dclaude",
   "bin": {