luv-cli 0.0.16__tar.gz → 0.0.18__tar.gz

{luv_cli-0.0.16 → luv_cli-0.0.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luv-cli
-Version: 0.0.16
+Version: 0.0.18
 Summary: Launch Claude Code agents on GitHub repos with isolated workspaces and optional Docker dev environments
 Project-URL: Homepage, https://github.com/exospherehost/luv
 Project-URL: Repository, https://github.com/exospherehost/luv
@@ -87,6 +87,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `luv [org/]<repo> -pr <number> [prompt]` | Open a PR by repo + number |
 | `luv --clean` | Delete workspaces where the branch is fully pushed/merged |
 | `luv --clean -f` | Force delete all workspaces |
+| `luv --clean --safe -f` | Force delete only workspaces older than 24h |
 
 ### Flags
 
@@ -96,8 +97,10 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `-r` | Resume: resume the last Claude session |
 | `-p` | Launch Claude in plan permission mode (default: `bypassPermissions`) |
 | `-nit` | Non-interactive: run `claude -p <prompt>` and exit (no REPL); streams `stream-json` events to stdout |
+| `-m MODEL` | Claude model to use (default: `claude-opus-4-7`); passed through to `claude --model`, so aliases like `opus`/`sonnet`/`haiku` work |
 | `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
+| `--safe` | With `--clean -f`, only delete workspaces older than 24h (mtime) |
 
 ## Docker dev environments
 
@@ -157,7 +160,7 @@ Docker mode works with all flags: `-n` opens a bash shell in the container, `-r`
 - No unpushed commits
 - If the remote branch is gone, verifies the PR was merged and local HEAD matches
 
-Use `luv --clean -f` to skip all safety checks and delete everything.
+Use `luv --clean -f` to skip all safety checks and delete everything. Add `--safe` (i.e. `luv --clean --safe -f`) to restrict force-delete to workspaces whose folder mtime is older than 24 hours, leaving recently-touched workspaces alone.
 
 ## Configuration
 

{luv_cli-0.0.16 → luv_cli-0.0.18}/README.md

@@ -64,6 +64,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `luv [org/]<repo> -pr <number> [prompt]` | Open a PR by repo + number |
 | `luv --clean` | Delete workspaces where the branch is fully pushed/merged |
 | `luv --clean -f` | Force delete all workspaces |
+| `luv --clean --safe -f` | Force delete only workspaces older than 24h |
 
 ### Flags
 
@@ -73,8 +74,10 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 | `-r` | Resume: resume the last Claude session |
 | `-p` | Launch Claude in plan permission mode (default: `bypassPermissions`) |
 | `-nit` | Non-interactive: run `claude -p <prompt>` and exit (no REPL); streams `stream-json` events to stdout |
+| `-m MODEL` | Claude model to use (default: `claude-opus-4-7`); passed through to `claude --model`, so aliases like `opus`/`sonnet`/`haiku` work |
 | `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
+| `--safe` | With `--clean -f`, only delete workspaces older than 24h (mtime) |
 
 ## Docker dev environments
 
@@ -134,7 +137,7 @@ Docker mode works with all flags: `-n` opens a bash shell in the container, `-r`
 - No unpushed commits
 - If the remote branch is gone, verifies the PR was merged and local HEAD matches
 
-Use `luv --clean -f` to skip all safety checks and delete everything.
+Use `luv --clean -f` to skip all safety checks and delete everything. Add `--safe` (i.e. `luv --clean --safe -f`) to restrict force-delete to workspaces whose folder mtime is older than 24 hours, leaving recently-touched workspaces alone.
 
 ## Configuration
 

{luv_cli-0.0.16 → luv_cli-0.0.18}/luv/__init__.py

@@ -6,6 +6,7 @@ import shutil
 import subprocess
 import sys
 import tempfile
+import time
 from pathlib import Path
 
 LUV_DIR = Path.home() / ".luv"
@@ -315,8 +316,10 @@ def navigate(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
         os.execv(shell, [shell])
 
 
-def resume(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
+def resume(clone_dir: Path, extra_env: dict[str, str] | None = None,
+           model: str = "claude-opus-4-7") -> None:
     """Trust, chdir, and exec claude --resume — replacing this process."""
+    extra_env = extra_env or {}
     trust_project(clone_dir)
     os.chdir(str(clone_dir))
     settings = load_luv_settings(clone_dir)
@@ -329,7 +332,7 @@ def resume(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
             base = docker_compose_base(clone_dir, compose_file, project)
             r = subprocess.run(base + ["exec", "-it"] + docker_env_flags(extra_env) + ["dev-environment",
                                        "claude", "--dangerously-skip-permissions",
-                                       "--model", "claude-opus-4-7",
+                                       "--model", model,
                                        "--effort", "max", "--resume",
                                        "--remote-control",
                                        "--remote-control-session-name-prefix", clone_dir.name])
@@ -342,21 +345,23 @@ def resume(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
             die("'claude' not found in PATH")
         os.environ.update(extra_env)
         os.execv(claude_bin, [claude_bin, "--dangerously-skip-permissions",
-                              "--model", "claude-opus-4-7", "--effort", "max", "--resume",
+                              "--model", model, "--effort", "max", "--resume",
                               "--remote-control",
                               "--remote-control-session-name-prefix", clone_dir.name])
 
 
 def launch(clone_dir: Path, prompt: str | None, plan_mode: bool = False,
-           non_interactive: bool = False, extra_env: dict[str, str] = {}) -> None:
+           non_interactive: bool = False, extra_env: dict[str, str] | None = None,
+           model: str = "claude-opus-4-7") -> None:
     """Trust, resolve claude, chdir, and exec — replacing this process."""
+    extra_env = extra_env or {}
     trust_project(clone_dir)
     os.chdir(str(clone_dir))
     settings = load_luv_settings(clone_dir)
     compose_file = (settings or {}).get("compose_file")
 
     common_flags = ["--dangerously-skip-permissions",
-                    "--model", "claude-opus-4-7",
+                    "--model", model,
                     "--effort", "max",
                     "--remote-control",
                     "--remote-control-session-name-prefix", clone_dir.name]
@@ -391,7 +396,10 @@ def launch(clone_dir: Path, prompt: str | None, plan_mode: bool = False,
         os.execv(claude_bin, [claude_bin] + common_flags + mode_flags + initial_args)
 
 
-def cmd_clean(force: bool = False) -> None:
+SAFE_AGE_SECONDS = 24 * 3600
+
+
+def cmd_clean(force: bool = False, safe: bool = False) -> None:
     """Scan ~/prs/ and delete fully-pushed, clean work folders."""
     if not PRS_DIR.exists():
         print("luv: nothing to clean (~/prs/ does not exist)")
@@ -399,6 +407,7 @@ def cmd_clean(force: bool = False) -> None:
 
     cleaned: list[str] = []
     skipped: list[tuple[str, str]] = []
+    now = time.time()
 
     for entry in sorted(PRS_DIR.iterdir()):
         if not entry.is_dir():
@@ -409,6 +418,9 @@ def cmd_clean(force: bool = False) -> None:
             continue  # doesn't match {repo}-{number} — skip silently
 
         if force:
+            if safe and (now - entry.stat().st_mtime) < SAFE_AGE_SECONDS:
+                skipped.append((entry.name, "younger than 24h (--safe)"))
+                continue
             shutil.rmtree(entry)
             cleaned.append(entry.name)
             continue
@@ -496,8 +508,9 @@ def find_latest_clone(repo: str) -> Path | None:
     return best
 
 
-def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, plan_mode: bool = False, non_interactive: bool = False, extra_env: dict[str, str] = {}) -> None:
+def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, plan_mode: bool = False, non_interactive: bool = False, extra_env: dict[str, str] | None = None, model: str = "claude-opus-4-7") -> None:
     """Open an existing work folder or remote branch by number."""
+    extra_env = extra_env or {}
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
     # 1. Local folder takes priority
@@ -507,9 +520,9 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
         if nav_mode:
             navigate(clone_dir, extra_env=extra_env)
         elif resume_mode:
-            resume(clone_dir, extra_env=extra_env)
+            resume(clone_dir, extra_env=extra_env, model=model)
         else:
-            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
+            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env, model=model)
         return  # unreachable
 
     # 2. Check remote branch luv-{number}
@@ -534,13 +547,14 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
     if nav_mode:
         navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir, extra_env=extra_env)
+        resume(clone_dir, extra_env=extra_env, model=model)
     else:
-        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env, model=model)
 
 
-def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, plan_mode: bool = False, non_interactive: bool = False, extra_env: dict[str, str] = {}) -> None:
+def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, plan_mode: bool = False, non_interactive: bool = False, extra_env: dict[str, str] | None = None, model: str = "claude-opus-4-7") -> None:
     """Open any GitHub PR by org/repo/number, cloning if needed."""
+    extra_env = extra_env or {}
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
     if clone_dir.exists():
@@ -549,9 +563,9 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
         if nav_mode:
             navigate(clone_dir, extra_env=extra_env)
         elif resume_mode:
-            resume(clone_dir, extra_env=extra_env)
+            resume(clone_dir, extra_env=extra_env, model=model)
         else:
-            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
+            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env, model=model)
         return  # unreachable
 
     # Resolve the actual branch name via GitHub API
@@ -576,9 +590,9 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
     if nav_mode:
         navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir, extra_env=extra_env)
+        resume(clone_dir, extra_env=extra_env, model=model)
     else:
-        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env, model=model)
 
 
 def main() -> None:
@@ -589,8 +603,23 @@ def main() -> None:
     plan_mode = "-p" in args
     non_interactive = "-nit" in args
     force = "-f" in args or "--force" in args
+    safe = "--safe" in args
     env_mode = "-e" in args
-    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force", "-p", "-nit")]
+
+    # -m takes a value, so extract it before the boolean-flag strip below
+    model = "claude-opus-4-7"
+    if args.count("-m") > 1:
+        die("-m may only be provided once")
+    if "-m" in args:
+        idx = args.index("-m")
+        if idx + 1 >= len(args):
+            die("-m requires a model name")
+        model = args[idx + 1].strip()
+        if not model or model.startswith("-"):
+            die("-m requires a model name")
+        args = args[:idx] + args[idx + 2:]
+
+    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force", "-p", "-nit", "--safe")]
     extra_env = collect_luv_env() if env_mode else {}
 
     if not args or args[0] in ("-h", "--help"):
@@ -602,8 +631,10 @@ Flags:
   -r            resume: resume the last Claude session in the work folder
   -p            launch Claude in plan permission mode (default: bypassPermissions)
   -nit          non-interactive: run claude -p <prompt> and exit (no REPL)
+  -m MODEL      claude model to use (default: claude-opus-4-7)
   -e            env: pass LUV_* environment variables (with prefix stripped) into the session
   -f, --force   (with --clean) skip safety checks and delete all work folders
+  --safe        (with --clean -f) only delete folders older than 24h
 
 Commands:
   luv --init                              configure default GitHub org
@@ -613,7 +644,7 @@ Commands:
   luv [org/]<repo> -pr <number> [prompt]  open a GitHub PR by repo + number
   luv [org/]<repo> -n                     open shell in latest local clone
   luv [org/]<repo> -r                     resume Claude in latest local clone
-  luv --clean [-f]                        delete fully-pushed work folders
+  luv --clean [-f] [--safe]               delete fully-pushed work folders
 
 Org resolution:
   Explicit org/repo overrides the default. Run 'luv --init' to set a default.
@@ -625,8 +656,11 @@ Docker:
   "dev-environment" service. Torn down automatically on exit.""")
         sys.exit(0)
 
+    if safe and (args[0] != "--clean" or not force):
+        die("--safe only works with --clean -f")
+
     if args[0] == "--clean":
-        cmd_clean(force=force)
+        cmd_clean(force=force, safe=safe)
         return
 
     if args[0] == "--init":
@@ -643,7 +677,7 @@ Docker:
             die(f"cannot parse PR URL: {url}")
         org, repo, number = m.group(1), m.group(2), int(m.group(3))
         prompt = " ".join(args[2:]) or None
-        open_pr(org, repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env)
+        open_pr(org, repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env, model=model)
         return
 
     raw = args[0].rstrip("/")
@@ -663,14 +697,14 @@ Docker:
             die(f"expected a PR number after -pr, got '{args[idx + 1]}'")
         prompt_parts = [a for i, a in enumerate(args) if i not in (0, idx, idx + 1)]
         prompt = " ".join(prompt_parts) or None
-        open_pr(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env)
+        open_pr(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env, model=model)
         return
 
     # Detect optional numeric second argument
     if len(args) > 1 and args[1].isdigit():
         number = int(args[1])
         prompt = " ".join(args[2:]) or None
-        open_existing(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env)
+        open_existing(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env, model=model)
         return
 
     org = resolve_org(explicit_org)
@@ -685,7 +719,7 @@ Docker:
         if nav_mode:
             navigate(clone_dir, extra_env=extra_env)
         else:
-            resume(clone_dir, extra_env=extra_env)
+            resume(clone_dir, extra_env=extra_env, model=model)
         return
 
     # 1. Verify repo exists
@@ -737,6 +771,6 @@ Docker:
     if nav_mode:
         navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir, extra_env=extra_env)
+        resume(clone_dir, extra_env=extra_env, model=model)
     else:
-        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env, model=model)

{luv_cli-0.0.16 → luv_cli-0.0.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "luv-cli"
-version = "0.0.16"
+version = "0.0.18"
 description = "Launch Claude Code agents on GitHub repos with isolated workspaces and optional Docker dev environments"
 requires-python = ">=3.10"
 license = "MIT"