luv-cli 0.0.1__tar.gz → 0.0.3__tar.gz

luv_cli-0.0.3/.claude/settings.json

@@ -0,0 +1,316 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook SessionStart",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook SessionEnd",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook UserPromptSubmit",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PreToolUse",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PermissionRequest",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PermissionDenied": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PermissionDenied",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PostToolUse",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PostToolUseFailure",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook Notification",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook SubagentStart",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook SubagentStop",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "TaskCreated": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook TaskCreated",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook TaskCompleted",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook Stop",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "StopFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook StopFailure",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook TeammateIdle",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "InstructionsLoaded": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook InstructionsLoaded",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook ConfigChange",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "CwdChanged": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook CwdChanged",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "FileChanged": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook FileChanged",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "WorktreeCreate": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook WorktreeCreate",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "WorktreeRemove": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook WorktreeRemove",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PreCompact",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook PostCompact",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "Elicitation": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook Elicitation",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ],
+    "ElicitationResult": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"/home/ubuntu/.nvm/versions/node/v24.14.0/bin/failproofai\" --hook ElicitationResult",
+            "timeout": 60000,
+            "__failproofai_hook__": true
+          }
+        ]
+      }
+    ]
+  }
+}

luv_cli-0.0.3/.failproofai/policies-config.json

@@ -0,0 +1,39 @@
+{
+  "enabledPolicies": [
+    "sanitize-jwt",
+    "sanitize-api-keys",
+    "sanitize-connection-strings",
+    "sanitize-private-key-content",
+    "sanitize-bearer-tokens",
+    "protect-env-vars",
+    "block-env-files",
+    "block-read-outside-cwd",
+    "block-sudo",
+    "block-curl-pipe-sh",
+    "block-rm-rf",
+    "block-failproofai-commands",
+    "block-secrets-write",
+    "block-push-master",
+    "block-force-push",
+    "block-work-on-main",
+    "warn-git-amend",
+    "warn-git-stash-drop",
+    "warn-all-files-staged",
+    "warn-destructive-sql",
+    "warn-schema-alteration",
+    "warn-package-publish",
+    "warn-global-package-install",
+    "warn-large-file-write",
+    "warn-background-process",
+    "warn-repeated-tool-calls",
+    "require-commit-before-stop",
+    "require-push-before-stop",
+    "require-pr-before-stop",
+    "require-ci-green-before-stop"
+  ],
+  "policyParams": {
+    "block-force-push": {
+      "hint": "Create a new branch from your current HEAD (e.g. `git checkout -b <new-branch>`) and push that instead."
+    }
+  }
+}

luv_cli-0.0.3/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+dist/
+*.egg-info/

{luv_cli-0.0.1 → luv_cli-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luv-cli
-Version: 0.0.1
+Version: 0.0.3
 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
@@ -94,6 +94,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 |------|-------------|
 | `-n` | Navigate: open a shell instead of Claude |
 | `-r` | Resume: resume the last Claude session |
+| `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
 
 ## Docker dev environments

{luv_cli-0.0.1 → luv_cli-0.0.3}/README.md

@@ -71,6 +71,7 @@ All workspaces live under `~/prs/`. The number comes from the repo's GitHub issu
 |------|-------------|
 | `-n` | Navigate: open a shell instead of Claude |
 | `-r` | Resume: resume the last Claude session |
+| `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
 
 ## Docker dev environments

{luv_cli-0.0.1 → luv_cli-0.0.3}/luv/__init__.py

@@ -119,6 +119,23 @@ def trust_project(path: Path) -> None:
     os.replace(tmp_path, CLAUDE_JSON)
 
 
+def collect_luv_env() -> dict[str, str]:
+    """Collect LUV_* env vars, strip prefix, return as dict."""
+    result = {}
+    for key, value in os.environ.items():
+        if key.startswith("LUV_") and len(key) > 4:
+            result[key[4:]] = value
+    return result
+
+
+def docker_env_flags(env_vars: dict[str, str]) -> list[str]:
+    """Convert env dict to docker compose exec -e flags."""
+    flags: list[str] = []
+    for key, value in env_vars.items():
+        flags.extend(["-e", f"{key}={value}"])
+    return flags
+
+
 def ensure_pr_rules() -> None:
     claude_dir = Path.home() / ".claude"
     claude_md = claude_dir / "CLAUDE.md"
@@ -229,7 +246,7 @@ def stop_docker(clone_dir: Path, compose_file: str, project: str) -> None:
     subprocess.run(base + ["down", "-v", "--remove-orphans"])
 
 
-def navigate(clone_dir: Path) -> None:
+def navigate(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
     """Chdir into the work folder and exec a shell — replacing this process."""
     os.chdir(str(clone_dir))
     settings = load_luv_settings(clone_dir)
@@ -240,16 +257,17 @@ def navigate(clone_dir: Path) -> None:
         start_docker(clone_dir, compose_file, project)
         try:
             base = docker_compose_base(clone_dir, compose_file, project)
-            r = subprocess.run(base + ["exec", "-it", "dev-environment", "bash"])
+            r = subprocess.run(base + ["exec", "-it"] + docker_env_flags(extra_env) + ["dev-environment", "bash"])
             sys.exit(r.returncode)
         finally:
             stop_docker(clone_dir, compose_file, project)
     else:
         shell = os.environ.get("SHELL", "/bin/bash")
+        os.environ.update(extra_env)
         os.execv(shell, [shell])
 
 
-def resume(clone_dir: Path) -> None:
+def resume(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
     """Trust, chdir, and exec claude --resume — replacing this process."""
     trust_project(clone_dir)
     os.chdir(str(clone_dir))
@@ -261,7 +279,7 @@ def resume(clone_dir: Path) -> None:
         start_docker(clone_dir, compose_file, project)
         try:
             base = docker_compose_base(clone_dir, compose_file, project)
-            r = subprocess.run(base + ["exec", "-it", "dev-environment",
+            r = subprocess.run(base + ["exec", "-it"] + docker_env_flags(extra_env) + ["dev-environment",
                                        "claude", "--dangerously-skip-permissions",
                                        "--model", "claude-opus-4-6",
                                        "--effort", "max", "--resume"])
@@ -272,11 +290,12 @@ def resume(clone_dir: Path) -> None:
         claude_bin = shutil.which("claude")
         if not claude_bin:
             die("'claude' not found in PATH")
+        os.environ.update(extra_env)
         os.execv(claude_bin, [claude_bin, "--dangerously-skip-permissions",
                               "--model", "claude-opus-4-6", "--effort", "max", "--resume"])
 
 
-def launch(clone_dir: Path, prompt: str | None) -> None:
+def launch(clone_dir: Path, prompt: str | None, extra_env: dict[str, str] = {}) -> None:
     """Trust, resolve claude, chdir, and exec — replacing this process."""
     trust_project(clone_dir)
     os.chdir(str(clone_dir))
@@ -293,7 +312,7 @@ def launch(clone_dir: Path, prompt: str | None) -> None:
                           "--model", "claude-opus-4-6", "--effort", "max"]
             if prompt:
                 claude_cmd.append(f"/plan {prompt}")
-            r = subprocess.run(base + ["exec", "-it", "dev-environment"] + claude_cmd)
+            r = subprocess.run(base + ["exec", "-it"] + docker_env_flags(extra_env) + ["dev-environment"] + claude_cmd)
             sys.exit(r.returncode)
         finally:
             stop_docker(clone_dir, compose_file, project)
@@ -304,6 +323,7 @@ def launch(clone_dir: Path, prompt: str | None) -> None:
         base_args = [claude_bin, "--dangerously-skip-permissions",
                      "--permission-mode", "bypassPermissions",
                      "--model", "claude-opus-4-6", "--effort", "max"]
+        os.environ.update(extra_env)
         if prompt:
             os.execv(claude_bin, base_args + [f"/plan {prompt}"])
         else:
@@ -398,7 +418,24 @@ def cmd_clean(force: bool = False) -> None:
         print("luv: nothing to clean")
 
 
-def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False) -> None:
+def find_latest_clone(repo: str) -> Path | None:
+    """Return the highest-numbered local {repo}-{N} folder, or None."""
+    if not PRS_DIR.exists():
+        return None
+    best: Path | None = None
+    best_num = -1
+    for entry in PRS_DIR.iterdir():
+        if not entry.is_dir():
+            continue
+        parts = entry.name.rsplit("-", 1)
+        if len(parts) == 2 and parts[0] == repo and parts[1].isdigit():
+            n = int(parts[1])
+            if n > best_num:
+                best, best_num = entry, n
+    return best
+
+
+def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, extra_env: dict[str, str] = {}) -> None:
     """Open an existing work folder or remote branch by number."""
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
@@ -407,11 +444,11 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
         print(f"luv: opening existing folder {clone_dir.name}")
         ensure_pr_rules()
         if nav_mode:
-            navigate(clone_dir)
+            navigate(clone_dir, extra_env=extra_env)
         elif resume_mode:
-            resume(clone_dir)
+            resume(clone_dir, extra_env=extra_env)
         else:
-            launch(clone_dir, prompt)
+            launch(clone_dir, prompt, extra_env=extra_env)
         return  # unreachable
 
     # 2. Check remote branch luv-{number}
@@ -434,14 +471,14 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
     print(f"luv: ready — {clone_dir.name}, branch {branch}")
     ensure_pr_rules()
     if nav_mode:
-        navigate(clone_dir)
+        navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir)
+        resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt)
+        launch(clone_dir, prompt, extra_env=extra_env)
 
 
-def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False) -> None:
+def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool = False, resume_mode: bool = False, extra_env: dict[str, str] = {}) -> None:
     """Open any GitHub PR by org/repo/number, cloning if needed."""
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
@@ -449,11 +486,11 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
         print(f"luv: opening existing folder {clone_dir.name}")
         ensure_pr_rules()
         if nav_mode:
-            navigate(clone_dir)
+            navigate(clone_dir, extra_env=extra_env)
         elif resume_mode:
-            resume(clone_dir)
+            resume(clone_dir, extra_env=extra_env)
         else:
-            launch(clone_dir, prompt)
+            launch(clone_dir, prompt, extra_env=extra_env)
         return  # unreachable
 
     # Resolve the actual branch name via GitHub API
@@ -476,11 +513,11 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
     print(f"luv: ready — {clone_dir.name}, branch {branch}")
     ensure_pr_rules()
     if nav_mode:
-        navigate(clone_dir)
+        navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir)
+        resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt)
+        launch(clone_dir, prompt, extra_env=extra_env)
 
 
 def main() -> None:
@@ -489,7 +526,9 @@ def main() -> None:
     nav_mode = "-n" in args
     resume_mode = "-r" in args
     force = "-f" in args or "--force" in args
-    args = [a for a in args if a not in ("-n", "-r", "-f", "--force")]
+    env_mode = "-e" in args
+    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force")]
+    extra_env = collect_luv_env() if env_mode else {}
 
     if not args or args[0] in ("-h", "--help"):
         print("""\
@@ -498,6 +537,7 @@ Usage: luv [flags] <command>
 Flags:
   -n            navigate: open a shell in the work folder instead of launching Claude
   -r            resume: resume the last Claude session in the work folder
+  -e            env: pass LUV_* environment variables (with prefix stripped) into the session
   -f, --force   (with --clean) skip safety checks and delete all work folders
 
 Commands:
@@ -506,6 +546,8 @@ Commands:
   luv [org/]<repo> <number> [prompt]      reopen an existing work folder by number
   luv -l <PR URL> [prompt]                open any GitHub PR by URL
   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
 
 Org resolution:
@@ -536,7 +578,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)
+        open_pr(org, repo, number, prompt, nav_mode, resume_mode, extra_env=extra_env)
         return
 
     raw = args[0].rstrip("/")
@@ -556,19 +598,31 @@ 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)
+        open_pr(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, extra_env=extra_env)
         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)
+        open_existing(resolve_org(explicit_org), repo, number, prompt, nav_mode, resume_mode, extra_env=extra_env)
         return
 
     org = resolve_org(explicit_org)
     prompt = " ".join(args[1:]) if len(args) > 1 else None
 
+    # luv <repo> -n/-r  →  open latest local clone (no new workspace)
+    if (nav_mode or resume_mode) and not prompt:
+        clone_dir = find_latest_clone(repo)
+        if clone_dir is None:
+            die(f"no local clones of '{repo}' found in {PRS_DIR}")
+        print(f"luv: opening latest clone {clone_dir.name}")
+        if nav_mode:
+            navigate(clone_dir, extra_env=extra_env)
+        else:
+            resume(clone_dir, extra_env=extra_env)
+        return
+
     # 1. Verify repo exists
     r = run(["gh", "api", f"repos/{org}/{repo}"])
     if r.returncode != 0:
@@ -610,8 +664,8 @@ Docker:
 
     # 7. Launch claude, resume session, or open shell (replace this process)
     if nav_mode:
-        navigate(clone_dir)
+        navigate(clone_dir, extra_env=extra_env)
     elif resume_mode:
-        resume(clone_dir)
+        resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt)
+        launch(clone_dir, prompt, extra_env=extra_env)

{luv_cli-0.0.1 → luv_cli-0.0.3}/pyproject.toml

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