aibox-cli 0.1.0 → 0.3.0

package/README.md

@@ -88,7 +88,7 @@ aibox generates a `compose.dev.yaml` and configures your IDE on `aibox init` (or
 2. Run `aibox init` in your project
 3. Set the plugin's startup command to:
    ```
-   /usr/local/bin/aibox claude --yolo
+   npx aibox claude --yolo
    ```
 
 The Node.js interpreter is also configured to use the container, so running/debugging from the IDE uses the same sandboxed environment.
@@ -147,17 +147,18 @@ SHARED_MODULES=false
 
 ## All Flags
 
-| Flag | Description |
-|------|-------------|
-| `--name NAME` | Named instance (multiple containers per project) |
-| `--image NAME` | Override base Docker image |
-| `--shared-modules` | Share node_modules between host and container |
-| `--copy` | Copy repo into Docker volume (full isolation) |
-| `--worktree` | Use git worktree (lightweight isolation) |
-| `--yolo` | Skip prompts, full sudo, no firewall |
-| `--safe` | Keep prompts, restricted sudo, firewall on |
-| `--all` | With `down`: stop all project containers |
-| `--clean` | With `down`: also remove copy volumes / worktrees |
+| Short | Long | Description |
+|-------|------|-------------|
+| `-n` | `--name NAME` | Named instance (multiple containers per project) |
+| `-d` | `--dir PATH` | Run in a different project directory |
+| `-i` | `--image NAME` | Override base Docker image |
+| `-c` | `--copy` | Copy repo into Docker volume (full isolation) |
+| `-w` | `--worktree` | Use git worktree (lightweight isolation) |
+| `-y` | `--yolo` | Skip prompts, full sudo, no firewall |
+| `-s` | `--safe` | Keep prompts, restricted sudo, firewall on |
+| | `--shared-modules` | Share node_modules between host and container |
+| | `--all` | With `down`: stop all project containers |
+| | `--clean` | With `down`: also remove copy volumes / worktrees |
 
 ## License
 

package/bin/aibox

@@ -20,14 +20,15 @@
 #   aibox help                    Show this help (default)
 #
 # Flags:
-#   --name NAME           Run a named instance (e.g. --name refactor)
+#   -n, --name NAME       Run a named instance (e.g. -n refactor)
 #                         Allows multiple containers per project
-#   --image NAME          Override base Docker image (default: aibox:latest)
+#   -d, --dir PATH        Run in a different project directory
+#   -i, --image NAME      Override base Docker image (default: aibox:latest)
+#   -c, --copy            Copy project into container (full isolation, no host sync)
+#   -w, --worktree        Use git worktree (lightweight isolation, stays on host)
+#   -y, --yolo            Yolo mode: skip permissions, full sudo, no firewall
+#   -s, --safe            Safe mode: keep permissions, restricted sudo, firewall on
 #   --shared-modules      Share node_modules between host and container
-#   --copy                Copy project into container (full isolation, no host sync)
-#   --worktree            Use git worktree (lightweight isolation, stays on host)
-#   --yolo                Yolo mode: skip permissions, full sudo, no firewall
-#   --safe                Safe mode: keep permissions, restricted sudo, firewall on
 #
 # Network firewall:
 #   Default: only allows Claude API, npm, GitHub, PyPI, SSH, DNS.
@@ -54,7 +55,7 @@ set -euo pipefail
 
 # ── Script identity ──────────────────────────────────────────────
 SCRIPT_NAME="$(basename "$0")"
-AIBOX_VERSION="5"
+AIBOX_VERSION="6"
 CONFIG_DIR="${HOME}/.config/aibox"
 DEFAULT_IMAGE="aibox:latest"
 CONTAINER_PREFIX="aibox"
@@ -183,6 +184,7 @@ _check_deps() {
 IMAGE="$DEFAULT_IMAGE"
 SHARED_MODULES=false
 INSTANCE_NAME=""
+PROJECT_DIR_FLAG=""
 DOWN_ALL=false
 DOWN_CLEAN=false
 SKIP_PERMISSIONS=false
@@ -193,24 +195,28 @@ POSITIONAL=()
 parse_flags() {
   while [[ $# -gt 0 ]]; do
     case "$1" in
-      --image)
+      -i|--image)
         IMAGE="${2:?'--image requires a value'}"
         shift 2
         ;;
-      --name)
+      -n|--name)
         INSTANCE_NAME="${2:?'--name requires a value'}"
         shift 2
         ;;
+      -d|--dir)
+        PROJECT_DIR_FLAG="${2:?'--dir requires a value'}"
+        shift 2
+        ;;
       --shared-modules)
         SHARED_MODULES=true
         shift
         ;;
-      --copy)
+      -c|--copy)
         [[ -n "$ISOLATION" ]] && { echo "Error: --copy and --worktree are mutually exclusive" >&2; exit 1; }
         ISOLATION="copy"
         shift
         ;;
-      --worktree)
+      -w|--worktree)
         [[ -n "$ISOLATION" ]] && { echo "Error: --copy and --worktree are mutually exclusive" >&2; exit 1; }
         ISOLATION="worktree"
         shift
@@ -223,11 +229,11 @@ parse_flags() {
         DOWN_CLEAN=true
         shift
         ;;
-      --yolo)
+      -y|--yolo)
         SKIP_PERMISSIONS=true
         shift
         ;;
-      --safe)
+      -s|--safe)
         SAFE_MODE=true
         shift
         ;;
@@ -254,7 +260,14 @@ elif [[ "$SAFE_MODE" == "true" ]]; then
 fi
 
 # ── Per-project config file (.aibox) ─────────────────────────────
-PROJECT_DIR="$(pwd)"
+if [[ -n "$PROJECT_DIR_FLAG" ]]; then
+  PROJECT_DIR="$(cd "$PROJECT_DIR_FLAG" 2>/dev/null && pwd)" || {
+    echo "Error: directory not found: $PROJECT_DIR_FLAG" >&2
+    exit 1
+  }
+else
+  PROJECT_DIR="$(pwd)"
+fi
 PROJECT_CONF="${PROJECT_DIR}/.aibox"
 
 # ── Safety: refuse to run in dangerous directories ───────────────
@@ -334,7 +347,7 @@ if ! [[ "$INSTANCE_NAME" =~ ^[a-z0-9_-]+$ ]]; then
   exit 1
 fi
 CONTAINER_NAME="${BASE_CONTAINER_NAME}-${INSTANCE_NAME}"
-WORKSPACE_DIR="/${PROJECT_NAME}"
+WORKSPACE_DIR="/workspace/${PROJECT_NAME}"
 
 # ── Isolation mode setup ─────────────────────────────────────────
 COPY_VOLUME=""
@@ -423,6 +436,16 @@ set -e
 # Fix auth volume ownership (Docker creates volumes as root)
 chown -R aibox:aibox /home/aibox/.claude 2>/dev/null || true
 
+# ── IDE path symlink ─────────────────────────────────────────
+# Create symlink so container paths match host paths for IDE integration.
+# Claude Code reports cwd-based paths to the IDE plugin; if they don't
+# match host paths, diffs break (empty left side, wrong file path).
+if [[ -n "${AIBOX_HOST_DIR:-}" && -n "${AIBOX_WORKSPACE_DIR:-}" \
+      && "$AIBOX_HOST_DIR" != "$AIBOX_WORKSPACE_DIR" ]]; then
+  mkdir -p "$(dirname "$AIBOX_HOST_DIR")"
+  ln -sfn "$AIBOX_WORKSPACE_DIR" "$AIBOX_HOST_DIR"
+fi
+
 # ── Mode-dependent setup ──────────────────────────────────────
 MODE="${AIBOX_MODE:-safe}"
 
@@ -522,7 +545,7 @@ _prepare_copy_volume() {
 
   # Check if volume already has content (--entrypoint bypasses su-exec drop)
   local has_content
-  has_content=$(docker run --rm --entrypoint sh -v "${COPY_VOLUME}:/${PROJECT_NAME}" "$IMAGE" -c "ls -A /${PROJECT_NAME} 2>/dev/null | head -1" 2>/dev/null || true)
+  has_content=$(docker run --rm --entrypoint sh -v "${COPY_VOLUME}:${WORKSPACE_DIR}" "$IMAGE" -c "ls -A ${WORKSPACE_DIR} 2>/dev/null | head -1" 2>/dev/null || true)
 
   if [[ -n "$has_content" ]]; then
     echo "Copy volume already populated (${COPY_VOLUME}). Reusing."
@@ -542,14 +565,15 @@ _prepare_copy_volume() {
   fi
 
   if ! cat "$bundle_file" | docker run --rm -i --entrypoint sh \
-      -v "${COPY_VOLUME}:/${PROJECT_NAME}" \
+      -v "${COPY_VOLUME}:${WORKSPACE_DIR}" \
       "$IMAGE" -c "
         cat > /tmp/repo.bundle
-        cd /${PROJECT_NAME}
+        mkdir -p ${WORKSPACE_DIR}
+        cd ${WORKSPACE_DIR}
         git clone /tmp/repo.bundle .
         rm /tmp/repo.bundle
         git checkout -b '${branch_name}' 2>/dev/null || git checkout '${branch_name}'
-        chown -R aibox:aibox /${PROJECT_NAME}
+        chown -R aibox:aibox ${WORKSPACE_DIR}
       "; then
     rm -f "$bundle_file"
     docker volume rm "$COPY_VOLUME" 2>/dev/null || true
@@ -635,6 +659,8 @@ _environment_yaml() {
   echo "${indent}- CLAUDE_CONFIG_DIR=/home/aibox/.claude"
   echo "${indent}- AIBOX_MODE=\${AIBOX_MODE:-safe}"
   echo "${indent}- AIBOX_EXTRA_DOMAINS=\${AIBOX_EXTRA_DOMAINS:-}"
+  echo "${indent}- AIBOX_HOST_DIR=${PROJECT_DIR}"
+  echo "${indent}- AIBOX_WORKSPACE_DIR=${WORKSPACE_DIR}"
 }
 
 # Build -e flags for docker exec from current terminal environment
@@ -696,7 +722,7 @@ services:
 $(_labels_yaml "      ")
     volumes:
 $(_volumes_yaml "      " "$PROJECT_DIR")
-    working_dir: ${WORKSPACE_DIR}
+    working_dir: ${PROJECT_DIR}
     environment:
 $(_environment_yaml "      ")
     stdin_open: true
@@ -724,7 +750,7 @@ services:
 $(_labels_yaml "      ")
     volumes:
 $(_volumes_yaml "      " ".")
-    working_dir: ${WORKSPACE_DIR}
+    working_dir: ${PROJECT_DIR}
     environment:
 $(_environment_yaml "      ")
     stdin_open: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aibox-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Run AI coding agents in isolated Docker containers",
   "author": "repalash <palash@shaders.app>",
   "license": "MIT",