aibox-cli 0.3.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
@@ -151,6 +159,8 @@ SHARED_MODULES=false
 |-------|------|-------------|
 | `-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) |

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)
@@ -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)" || {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aibox-cli",
-  "version": "0.3.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"
   }
 }