okstra 0.162.2 → 0.163.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.162.2",
+  "version": "0.163.0",
   "description": "Host-aware multi-provider cross-verification orchestrator runtime and agent skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.162.2",
-  "builtAt": "2026-08-08T18:44:32.842Z",
+  "package": "0.163.0",
+  "builtAt": "2026-08-09T07:22:48.148Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/runtime/bin/lib/okstra/cli.sh

@@ -94,6 +94,10 @@ while [[ $# -gt 0 ]]; do
       REPORT_WRITER_MODEL_OVERRIDE="$(require_option_value --report-writer-model "${2-}")"
       shift 2
       ;;
+    --launch-only)
+      LAUNCH_ONLY="true"
+      shift
+      ;;
     --lead-runtime)
       LEAD_RUNTIME="$(require_option_value --lead-runtime "${2-}")"
       shift 2

package/runtime/bin/lib/okstra/globals.sh

@@ -164,3 +164,6 @@ REPORT_WRITER_MODEL_EXECUTION_VALUE=""
 DEFAULT_WORKERS="claude,codex,report-writer"
 DISPLAY_COMMAND_NAME="${OKSTRA_COMMAND_NAME:-$(basename "$0")}"
 DISPLAY_TOOL_NAME="${OKSTRA_TOOL_NAME:-okstra}"
+
+# `okstra run <lead>` 전용: 번들을 준비하지 않고 리드 CLI 만 띄운다.
+LAUNCH_ONLY="false"

package/runtime/bin/okstra.sh

@@ -71,6 +71,58 @@ if [[ "$RESUME_CLARIFICATION_MODE" == "true" ]]; then
   exit 0
 fi
 autofill_from_project_json
+
+# `okstra run <lead>` — open the host, nothing else. The okstra-run skill inside
+# it collects task inputs, which is how the Claude Code path has always worked.
+# Preparing a bundle here would demand a task id before the user has a session
+# to choose one in.
+if [[ "$LAUNCH_ONLY" == "true" ]]; then
+  if [[ -z "$PROJECT_ROOT" ]]; then
+    PROJECT_ROOT="$(resolve_project_root_strict "$PROJECT_ROOT_OVERRIDE")" || exit 1
+  fi
+  read -r LEAD_EXECUTABLE SANDBOX_NOTE < <(
+    okstra_py - "$LEAD_RUNTIME" <<'PY'
+import sys
+from okstra_ctl.lead_runtime import lead_runtime_info
+from okstra_ctl.models import bare_lead_launch_argv, lead_launch_spec
+provider = lead_runtime_info(sys.argv[1]).agent
+print(bare_lead_launch_argv(provider)[0], lead_launch_spec(provider).sandbox_waiver_note)
+PY
+  )
+  if ! command -v "$LEAD_EXECUTABLE" >/dev/null 2>&1; then
+    printf '%s command not found\n' "$LEAD_EXECUTABLE" >&2
+    exit 1
+  fi
+  if [[ -n "$SANDBOX_NOTE" ]]; then
+    okstra_py - "$LEAD_RUNTIME" <<'PY' >&2
+import sys
+from okstra_ctl.lead_runtime import lead_runtime_info
+from okstra_ctl.models import lead_launch_spec
+print("\n" + lead_launch_spec(lead_runtime_info(sys.argv[1]).agent).sandbox_waiver_note)
+PY
+    if [[ "$ASSUME_YES" != "true" ]]; then
+      printf 'Start %s without its sandbox? [y/N] ' "$LEAD_EXECUTABLE" >&2
+      read -r _sandbox_answer < /dev/tty || _sandbox_answer=""
+      if [[ "$_sandbox_answer" != "y" && "$_sandbox_answer" != "Y" ]]; then
+        printf 'okstra: cancelled\n' >&2
+        exit 1
+      fi
+    fi
+  fi
+  LAUNCH_ARGV=()
+  while IFS= read -r -d '' _arg; do LAUNCH_ARGV+=("$_arg"); done < <(
+    okstra_py - "$LEAD_RUNTIME" <<'PY'
+import sys
+from okstra_ctl.lead_runtime import lead_runtime_info
+from okstra_ctl.models import bare_lead_launch_argv
+for a in bare_lead_launch_argv(lead_runtime_info(sys.argv[1]).agent):
+    sys.stdout.write(a + "\0")
+PY
+  )
+  cd "$PROJECT_ROOT"
+  exec "${LAUNCH_ARGV[@]}"
+fi
+
 autofill_from_manifest
 collect_required_arguments
 

package/runtime/python/okstra_ctl/models.py

@@ -247,6 +247,18 @@ def lead_launch_spec(provider: str) -> LeadLaunchSpec:
     return spec.lead_launch
 
 
+def bare_lead_launch_argv(provider: str) -> list[str]:
+    """Start this provider's CLI with nothing to do yet.
+
+    `okstra run <lead>` opens the host; the okstra-run skill inside it collects
+    task inputs, exactly as the Claude Code path already works. So there is no
+    prompt and no model to pin here — only the flags that make the session
+    usable to okstra at all.
+    """
+    launch = lead_launch_spec(provider)
+    return [launch.executable, *launch.sandbox_waiver]
+
+
 def lead_launch_argv(
     provider: str,
     *,

package/src/commands/execute/run.mjs

@@ -32,6 +32,8 @@ const RUNTIME_ALIASES = new Map([
   ["claude-code", "claude-code"],
   ["codex", "codex"],
   ["antigravity", "antigravity"],
+  ["avg", "antigravity"],
+  ["agy", "antigravity"],
   ["external", "external"],
 ]);
 
@@ -110,10 +112,18 @@ export function buildRunPlan({ args, paths, resolution, runManifestPath = "" })
       // Handed to okstra.sh, which owns input collection and the launch. Only
       // the runtime is decided here; everything else is passed through so the
       // launcher can prompt for whatever is still missing.
+      // --launch-only: open the host and stop. Task inputs are collected by the
+      // okstra-run skill inside the session, which is how the Claude Code path
+      // has always worked — demanding a task id out here asks for it before the
+      // user has a session to pick one in.
       commands: [
         {
           name: "launcher",
-          args: ["--lead-runtime", resolution.resolvedRuntime, ...withoutRuntimeSelection(args)],
+          args: [
+            "--launch-only",
+            "--lead-runtime", resolution.resolvedRuntime,
+            ...withoutRuntimeSelection(args),
+          ],
           capture: false,
         },
       ],