aibox-cli 0.2.0 → 0.4.1

package/README.md

@@ -19,11 +19,8 @@ On macOS, if Docker isn't installed, aibox will offer to install [Colima](https:
 ## Usage
 
 ```bash
-# first time (once)
-aibox build
-
 # in any project directory
-aibox up                    # start container
+aibox up                    # start container (auto-builds image on first run)
 aibox claude --yolo         # no prompts, full sudo, no firewall
 aibox claude --safe         # keep prompts, restricted sudo, firewall on
 aibox claude                # asks you each time
@@ -71,6 +68,17 @@ aibox down --all          # stop all containers for this project
 aibox nuke                # remove ALL aibox containers
 ```
 
+### From a Git Repo
+
+Start directly from a repo URL — aibox clones it and runs:
+
+```bash
+aibox --repo https://github.com/user/project.git claude --yolo
+aibox --repo git@github.com:user/project.git --branch dev claude
+```
+
+Repos are cloned to `~/.config/aibox/repos/` with `--recursive` (submodules included). On subsequent runs, the existing clone is reused.
+
 ### Custom Image
 
 ```bash
@@ -88,7 +96,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 +155,20 @@ 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 |
+| `-r` | `--repo URL` | Clone a git repo and run in it |
+| `-b` | `--branch NAME` | Branch to checkout (with `--repo`) |
+| `-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

@@ -23,6 +23,8 @@
 #   -n, --name NAME       Run a named instance (e.g. -n refactor)
 #                         Allows multiple containers per project
 #   -d, --dir PATH        Run in a different project directory
+#   -r, --repo URL        Clone a git repo and run in it
+#   -b, --branch NAME     Branch to checkout (with --repo)
 #   -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)
@@ -55,7 +57,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"
@@ -185,6 +187,8 @@ IMAGE="$DEFAULT_IMAGE"
 SHARED_MODULES=false
 INSTANCE_NAME=""
 PROJECT_DIR_FLAG=""
+REPO_URL=""
+REPO_BRANCH=""
 DOWN_ALL=false
 DOWN_CLEAN=false
 SKIP_PERMISSIONS=false
@@ -207,6 +211,14 @@ parse_flags() {
         PROJECT_DIR_FLAG="${2:?'--dir requires a value'}"
         shift 2
         ;;
+      -r|--repo)
+        REPO_URL="${2:?'--repo requires a value'}"
+        shift 2
+        ;;
+      -b|--branch)
+        REPO_BRANCH="${2:?'--branch requires a value'}"
+        shift 2
+        ;;
       --shared-modules)
         SHARED_MODULES=true
         shift
@@ -259,6 +271,31 @@ elif [[ "$SAFE_MODE" == "true" ]]; then
   export AIBOX_MODE="safe"
 fi
 
+# ── Repo clone ───────────────────────────────────────────────────
+if [[ -n "$REPO_URL" ]]; then
+  # Derive a directory name from the repo URL (hash prevents collisions)
+  _repo_name=$(basename "$REPO_URL" .git)
+  _repo_hash=$(printf '%s' "$REPO_URL" | shasum | cut -c1-6)
+  _repo_dir="${CONFIG_DIR}/repos/${_repo_name}-${_repo_hash}"
+
+  if [[ -d "$_repo_dir/.git" ]]; then
+    echo "Repo already cloned (${_repo_dir}). Reusing."
+    # Fetch latest and checkout branch if specified
+    if [[ -n "$REPO_BRANCH" ]]; then
+      git -C "$_repo_dir" fetch --all --quiet 2>/dev/null || true
+      git -C "$_repo_dir" checkout "$REPO_BRANCH" 2>/dev/null || true
+    fi
+  else
+    echo "Cloning ${REPO_URL}..."
+    mkdir -p "${CONFIG_DIR}/repos"
+    _clone_args=(--recursive)
+    [[ -n "$REPO_BRANCH" ]] && _clone_args+=(--branch "$REPO_BRANCH")
+    git clone "${_clone_args[@]}" "$REPO_URL" "$_repo_dir"
+  fi
+
+  PROJECT_DIR_FLAG="$_repo_dir"
+fi
+
 # ── Per-project config file (.aibox) ─────────────────────────────
 if [[ -n "$PROJECT_DIR_FLAG" ]]; then
   PROJECT_DIR="$(cd "$PROJECT_DIR_FLAG" 2>/dev/null && pwd)" || {
@@ -347,7 +384,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=""
@@ -436,6 +473,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}"
 
@@ -535,7 +582,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."
@@ -555,14 +602,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
@@ -648,6 +696,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
@@ -709,7 +759,7 @@ services:
 $(_labels_yaml "      ")
     volumes:
 $(_volumes_yaml "      " "$PROJECT_DIR")
-    working_dir: ${WORKSPACE_DIR}
+    working_dir: ${PROJECT_DIR}
     environment:
 $(_environment_yaml "      ")
     stdin_open: true
@@ -737,7 +787,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.2.0",
+  "version": "0.4.1",
   "description": "Run AI coding agents in isolated Docker containers",
   "author": "repalash <palash@shaders.app>",
   "license": "MIT",
@@ -35,5 +35,8 @@
   ],
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "release": "git tag v$npm_package_version && git push origin v$npm_package_version"
   }
 }