[luv-21] Add -p (plan mode) and -nit (non-interactive); drop plan-mode default for prompts (#21)

Prompts no longer auto-enable Claude's plan permission mode. Pass -p to opt
into plan mode; pass -nit to run claude -p <prompt> non-interactively. Bumps
version to 0.0.15.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: NiveditJain

README.md

@@ -71,6 +71,8 @@ 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 |
+| `-p` | Launch Claude in plan permission mode (default: `bypassPermissions`) |
+| `-nit` | Non-interactive: run `claude -p <prompt>` and exit (no REPL) |
 | `-e` | Env: pass `LUV_*` environment variables (with prefix stripped) into the session |
 | `-f`, `--force` | Skip safety checks (with `--clean`) |
 

luv/__init__.py

@@ -347,7 +347,8 @@ def resume(clone_dir: Path, extra_env: dict[str, str] = {}) -> None:
                               "--remote-control-session-name-prefix", clone_dir.name])
 
 
-def launch(clone_dir: Path, prompt: str | None, extra_env: dict[str, str] = {}) -> None:
+def launch(clone_dir: Path, prompt: str | None, plan_mode: bool = False,
+           non_interactive: bool = False, extra_env: dict[str, str] = {}) -> None:
     """Trust, resolve claude, chdir, and exec — replacing this process."""
     trust_project(clone_dir)
     os.chdir(str(clone_dir))
@@ -359,12 +360,17 @@ def launch(clone_dir: Path, prompt: str | None, extra_env: dict[str, str] = {})
                     "--effort", "max",
                     "--remote-control",
                     "--remote-control-session-name-prefix", clone_dir.name]
-    if prompt:
+    if non_interactive:
+        if not prompt:
+            die("-nit requires a prompt")
+        mode_flags = []
+        initial_args = ["-p", prompt]
+    elif plan_mode:
         mode_flags = ["--permission-mode", "plan"]
-        initial_args = [prompt]
+        initial_args = [prompt] if prompt else [f"/color {pick_color()}"]
     else:
         mode_flags = ["--permission-mode", "bypassPermissions"]
-        initial_args = [f"/color {pick_color()}"]
+        initial_args = [prompt] if prompt else [f"/color {pick_color()}"]
 
     if compose_file:
         project = docker_project_name(clone_dir)
@@ -489,7 +495,7 @@ 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, 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:
     """Open an existing work folder or remote branch by number."""
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
@@ -502,7 +508,7 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
         elif resume_mode:
             resume(clone_dir, extra_env=extra_env)
         else:
-            launch(clone_dir, prompt, extra_env=extra_env)
+            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
         return  # unreachable
 
     # 2. Check remote branch luv-{number}
@@ -529,10 +535,10 @@ def open_existing(org: str, repo: str, number: int, prompt: str | None, nav_mode
     elif resume_mode:
         resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
 
 
-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:
+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:
     """Open any GitHub PR by org/repo/number, cloning if needed."""
     clone_dir = PRS_DIR / f"{repo}-{number}"
 
@@ -544,7 +550,7 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
         elif resume_mode:
             resume(clone_dir, extra_env=extra_env)
         else:
-            launch(clone_dir, prompt, extra_env=extra_env)
+            launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
         return  # unreachable
 
     # Resolve the actual branch name via GitHub API
@@ -571,17 +577,19 @@ def open_pr(org: str, repo: str, number: int, prompt: str | None, nav_mode: bool
     elif resume_mode:
         resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)
 
 
 def main() -> None:
     args = sys.argv[1:]
 
     nav_mode = "-n" in args
     resume_mode = "-r" in args
+    plan_mode = "-p" in args
+    non_interactive = "-nit" in args
     force = "-f" in args or "--force" in args
     env_mode = "-e" in args
-    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force")]
+    args = [a for a in args if a not in ("-n", "-r", "-e", "-f", "--force", "-p", "-nit")]
     extra_env = collect_luv_env() if env_mode else {}
 
     if not args or args[0] in ("-h", "--help"):
@@ -591,6 +599,8 @@ def main() -> None:
 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
+  -p            launch Claude in plan permission mode (default: bypassPermissions)
+  -nit          non-interactive: run claude -p <prompt> and exit (no REPL)
   -e            env: pass LUV_* environment variables (with prefix stripped) into the session
   -f, --force   (with --clean) skip safety checks and delete all work folders
 
@@ -632,7 +642,7 @@ def main() -> None:
             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, extra_env=extra_env)
+        open_pr(org, repo, number, prompt, nav_mode, resume_mode, plan_mode, non_interactive, extra_env=extra_env)
         return
 
     raw = args[0].rstrip("/")
@@ -652,14 +662,14 @@ def main() -> None:
             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, 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)
         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, 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)
         return
 
     org = resolve_org(explicit_org)
@@ -728,4 +738,4 @@ def _latest(endpoint: str) -> int:
     elif resume_mode:
         resume(clone_dir, extra_env=extra_env)
     else:
-        launch(clone_dir, prompt, extra_env=extra_env)
+        launch(clone_dir, prompt, plan_mode=plan_mode, non_interactive=non_interactive, extra_env=extra_env)

pyproject.toml

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