loki-mode 7.125.0 → 7.126.0

package/README.md

@@ -483,6 +483,7 @@ Status legend: "E2E-verified" means we run real spec-to-code builds on it oursel
 | `loki modernize heal <path>` | Legacy system healing (archaeology, stabilize, isolate, modernize, validate -- v6.67.0; was: `loki heal`) |
 | `loki pause` / `resume` | Pause/resume after current session |
 | `loki status` | Show current status |
+| `loki cockpit` | Live multi-repo status as an inline terminal image (Kitty/iTerm2/WezTerm/Ghostty); text + dashboard fallback elsewhere (v7.126.0) |
 | `loki dashboard` | Open web dashboard |
 | `loki preview` | Print running app URL and open in browser (Live App Preview, v7.24.0; was: `loki open`) |
 | `loki web` | Launch Purple Lab web UI [DEPRECATED in v7.44.0 -- use `loki start` which auto-opens the dashboard at http://localhost:57374; for the hosted platform see Autonomi Cloud] |

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Autonomous spec-driven build system with a built-in trust layer. It does not call work done until it is verified (RARV-C closure loop, 8 quality gates, completion council, verified-completion evidence gate). Triggers on "Loki Mode". Takes a spec (PRD, GitHub issue, OpenAPI doc, etc.) to deployed product with minimal human intervention. Provider-agnostic. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v7.125.0
+# Loki Mode v7.126.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -408,4 +408,4 @@ See `CHANGELOG.md` entries [7.5.7], [7.5.8], [7.5.13] for the per-fix list and r
 
 ---
 
-**v7.125.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.126.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.125.0
+7.126.0

package/autonomy/lib/cockpit-render.sh

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+# autonomy/lib/cockpit-render.sh -- state gathering + render dispatch for
+# `loki cockpit`. Thin wrapper: it builds a CockpitState JSON from the machine
+# registry + each project's .loki state, then pipes it to the pure Bun render
+# pipeline (loki-ts/src/cockpit/cli.ts). All the SVG/PNG/terminal-encode logic
+# lives there so it stays bun-testable; this file only does I/O and fallback.
+#
+# Contract with the TS entry:
+#   stdin  : CockpitState JSON
+#   stdout : raw terminal image escape (image path), empty on fallback
+#   exit 0 : image emitted ; exit 3 : fallback (reason on stderr as FALLBACK\t..)
+#   other  : hard error (bun missing etc.) -> caller falls back too
+#
+# Nothing here changes cmd_watch or any existing command.
+
+# cockpit_gather_state <skill_dir> <focus_repo_or_empty>
+# Emits a CockpitState JSON on stdout. Never fails hard: missing files degrade
+# to empty/default fields so the render always has something to show.
+cockpit_gather_state() {
+    local skill_dir="$1"
+    local focus_repo="${2:-}"
+
+    if ! command -v python3 >/dev/null 2>&1; then
+        # No python: emit a minimal single-repo state from the cwd only.
+        printf '{"run":"%s","iteration":0,"phase":"unknown","tier":"","provider":"","verdict":"unknown","budgetUsd":0,"gates":[],"council":[],"fleet":[]}\n' \
+            "$(basename "$(pwd)")"
+        return 0
+    fi
+
+    LOKI_CK_SKILL="$skill_dir" LOKI_CK_FOCUS="$focus_repo" LOKI_CK_CWD="$(pwd)" \
+    python3 - <<'PYCOCKPIT' 2>/dev/null || printf '{"run":"cockpit","iteration":0,"phase":"unknown","tier":"","provider":"","verdict":"unknown","budgetUsd":0,"gates":[],"council":[],"fleet":[]}\n'
+import json, os, sys
+
+skill = os.environ.get("LOKI_CK_SKILL", ".")
+focus = (os.environ.get("LOKI_CK_FOCUS") or "").strip()
+cwd = os.environ.get("LOKI_CK_CWD") or os.getcwd()
+sys.path.insert(0, skill)
+
+
+def read_json(path):
+    try:
+        with open(path) as f:
+            return json.load(f)
+    except Exception:
+        return {}
+
+
+def project_state(path):
+    """Best-effort per-project state from its .loki/ files."""
+    loki = os.path.join(path, ".loki")
+    st = read_json(os.path.join(loki, "autonomy-state.json"))
+    ev = read_json(os.path.join(loki, "verify", "evidence.json"))
+
+    iteration = st.get("iterationCount", st.get("iteration", 0)) or 0
+    phase = st.get("phase") or st.get("status") or ""
+
+    verdict = "unknown"
+    v = str(ev.get("verdict", "")).upper()
+    if v in ("PASS", "VERIFIED"):
+        verdict = "verified"
+    elif v in ("BLOCKED", "FAIL", "FAILED"):
+        verdict = "failed"
+    elif v in ("WORKING", "PARTIAL", "INCONCLUSIVE"):
+        verdict = "working"
+    elif v:
+        verdict = "pending"
+
+    gates = []
+    for g in ev.get("deterministic_gates", []) or []:
+        gs = str(g.get("status", "")).lower()
+        status = {"pass": "pass", "fail": "fail", "failed": "fail",
+                  "skipped": "skip", "skip": "skip"}.get(gs, "pending")
+        gates.append({"name": g.get("gate", "gate"), "status": status})
+
+    # Council votes: .loki/council/*.json, each with a vote-ish field.
+    council = []
+    cdir = os.path.join(loki, "council")
+    try:
+        for fn in sorted(os.listdir(cdir)):
+            if not fn.endswith(".json"):
+                continue
+            cj = read_json(os.path.join(cdir, fn))
+            raw = str(cj.get("vote") or cj.get("verdict") or "").lower()
+            vote = "pending"
+            if "approve" in raw:
+                vote = "approve"
+            elif "reject" in raw:
+                vote = "reject"
+            elif "concern" in raw:
+                vote = "concern"
+            reviewer = cj.get("reviewer") or cj.get("name") or os.path.splitext(fn)[0]
+            council.append({"reviewer": str(reviewer)[:16], "vote": vote})
+    except Exception:
+        pass
+
+    return {
+        "iteration": int(iteration) if isinstance(iteration, (int, float)) else 0,
+        "phase": phase or "idle",
+        "verdict": verdict,
+        "gates": gates,
+        "council": council,
+        "budgetUsd": float(st.get("cost_usd", 0.0) or 0.0),
+        "tier": st.get("tier", "") or "",
+        "provider": st.get("provider", "") or "",
+    }
+
+
+# Fleet from the registry; graceful empty on any failure.
+fleet = []
+runs = []
+try:
+    from dashboard import registry
+    runs = registry.get_fleet_runs(include_inactive=True)
+except Exception:
+    runs = []
+
+for r in runs:
+    fleet.append({
+        "name": r.get("name") or os.path.basename(r.get("path", "") or "project"),
+        "phase": r.get("phase", "") or "",
+        "iteration": r.get("iteration", 0) or 0,
+        "status": r.get("status", "") or "",
+        "running": bool(r.get("running")),
+    })
+
+# Focused run: --repo wins; else first running fleet run; else cwd.
+focus_path = focus or cwd
+focus_entry = None
+for r in runs:
+    rp = os.path.abspath(r.get("path", "") or "")
+    if rp and rp == os.path.abspath(focus_path):
+        focus_entry = r
+        break
+if focus_entry is None and not focus:
+    for r in runs:
+        if r.get("running"):
+            focus_entry = r
+            focus_path = r.get("path", "") or cwd
+            break
+
+ps = project_state(focus_path)
+run_name = (focus_entry or {}).get("name") if focus_entry else os.path.basename(os.path.abspath(focus_path))
+
+# Registry values override file reads where present (registry is fresher).
+if focus_entry:
+    if focus_entry.get("iteration"):
+        ps["iteration"] = focus_entry["iteration"]
+    if focus_entry.get("phase"):
+        ps["phase"] = focus_entry["phase"]
+    if focus_entry.get("cost_usd"):
+        ps["budgetUsd"] = float(focus_entry["cost_usd"])
+
+state = {
+    "run": run_name or "cockpit",
+    "iteration": ps["iteration"],
+    "phase": ps["phase"],
+    "tier": ps["tier"] or (os.environ.get("LOKI_SESSION_MODEL", "")),
+    "provider": ps["provider"] or (os.environ.get("LOKI_PROVIDER", "claude")),
+    "verdict": ps["verdict"],
+    "budgetUsd": ps["budgetUsd"],
+    "budgetLimitUsd": float(os.environ.get("LOKI_MAX_BUDGET_USD", "0") or 0) or None,
+    "freshness": "now",
+    "gates": ps["gates"],
+    "council": ps["council"],
+    "fleet": fleet,
+}
+print(json.dumps(state))
+PYCOCKPIT
+}
+
+# cockpit_render <skill_dir> <ts_dir> <protocol> <no_image> <focus_repo>
+# Returns: 0 (image emitted to stdout), 3 (fallback), or 2 (bun unavailable).
+# On fallback / bun-missing the caller is responsible for the text summary.
+cockpit_render() {
+    local skill_dir="$1" ts_dir="$2" protocol="${3:-auto}" no_image="${4:-0}" focus_repo="${5:-}"
+
+    # Prefer the shipped bundle (dist/cockpit.js -- present in npm/Docker/brew
+    # installs, which ship loki-ts/dist/ but not src/); fall back to the source
+    # entry for in-repo development.
+    local entry="$ts_dir/dist/cockpit.js"
+    [ -f "$entry" ] || entry="$ts_dir/src/cockpit/cli.ts"
+    if ! command -v bun >/dev/null 2>&1 || [ ! -f "$entry" ]; then
+        return 2
+    fi
+
+    local args=(--protocol "$protocol")
+    [ "$no_image" = "1" ] && args+=(--no-image)
+
+    # Gather -> render. Preserve the TS exit code (0 image / 3 fallback).
+    cockpit_gather_state "$skill_dir" "$focus_repo" | bun "$entry" "${args[@]}"
+}

package/autonomy/loki

@@ -959,6 +959,7 @@ show_help() {
     echo "  loki config set maxTier sonnet   # Cap model cost"
     echo "  loki dashboard start          # Web dashboard at localhost:57374"
     echo "  loki watch                    # Auto-rerun on PRD changes"
+    echo "  loki cockpit                  # Live multi-repo cockpit (terminal image)"
     echo "  loki remote                   # Remote session (phone/browser)"
     echo ""
     echo "Phase A-J features (v7.5.18 - v7.5.28) are default-on. See CHANGELOG."
@@ -1156,6 +1157,170 @@ detect_arg_type() {
     echo "unknown"
 }
 
+# --- loki start detach-default handoff (S1) --------------------------------
+# On an interactive TTY, `loki start` now detaches the build to the background
+# by default after a rich, reversible handoff card. A non-interactive shell,
+# --bg, --yes/-y, or CI takes the exact pre-existing foreground path (no card,
+# byte-identical behavior). See tests/test-start-handoff.sh.
+
+# Decide whether the interactive handoff should fire. Returns 0 (fire) only when
+# stdout is a TTY, --bg was not requested, auto-confirm/-y is off, and we are not
+# in CI / a non-interactive shell. Any other case returns 1 (take today's path).
+# $1 = "1" if --bg is present in args, else "".
+_loki_start_should_handoff() {
+    local bg_requested="${1:-}"
+    [ "$bg_requested" = "1" ] && return 1
+    [ -t 1 ] || return 1
+    [ -t 0 ] || return 1
+    [ "${LOKI_AUTO_CONFIRM:-}" = "true" ] && return 1
+    [ "${CI:-}" = "true" ] && return 1
+    [ "${LOKI_NO_HANDOFF:-}" = "1" ] && return 1
+    return 0
+}
+
+# Stare-worthy brand banner (S6). Renders the real Autonomi logo (purple squircle
+# + white "A" + teal dot) as a crafted truecolor block, next to a "LOKI" wordmark,
+# straight to stderr. ZERO new tooling: pure ANSI escapes. Degrades by color depth
+# ($COLORTERM truecolor -> 24-bit; else a clean 256/mono badge). Never required,
+# always the default -- this is the moment the user stares at.
+_loki_brand_banner() {
+    local proj="$1"
+    local nc=$'\033[0m' b=$'\033[1m' dim=$'\033[2m'
+    # Truecolor when the terminal advertises it (nearly all modern terminals).
+    if [ "${COLORTERM:-}" = "truecolor" ] || [ "${COLORTERM:-}" = "24bit" ]; then
+        local pB=$'\033[48;2;85;61;233m'    # squircle purple bg #553DE9
+        local wF=$'\033[38;2;255;254;251m'  # white A
+        local tF=$'\033[38;2;31;197;168m'   # teal dot
+        local pF=$'\033[38;2;123;107;240m'  # light purple wordmark
+        # 6-row squircle badge; each cell two chars. '#'=A stroke, 'o'=teal dot.
+        local rows=(
+            "......"
+            "..##.."
+            ".#..#."
+            ".####."
+            ".#.o#."
+            ".#..#."
+        )
+        printf '\n' >&2
+        local i=0 line r c ch
+        for r in "${rows[@]}"; do
+            line=""
+            for ((c=0; c<${#r}; c++)); do
+                ch="${r:$c:1}"
+                case "$ch" in
+                    '#') line+="${pB}${wF}\xE2\x96\x88\xE2\x96\x88${nc}" ;;
+                    'o') line+="${pB}${tF}\xE2\x97\x8F ${nc}" ;;
+                    *)   line+="${pB}  ${nc}" ;;
+                esac
+            done
+            # Wordmark + tagline riding beside the badge on two of the rows.
+            case $i in
+                2) printf "   %b   %b%bLOKI%b\n" "$line" "$b" "$pF" "$nc" >&2 ;;
+                3) printf "   %b   %bAutonomi cockpit%b\n" "$line" "$dim" "$nc" >&2 ;;
+                *) printf "   %b\n" "$line" >&2 ;;
+            esac
+            i=$((i+1))
+        done
+        printf '\n' >&2
+    else
+        # 256-color / limited: a compact, still-branded badge (no truecolor blocks).
+        local p=$'\033[38;5;99m' t=$'\033[38;5;43m'
+        printf '\n   %s%s\xE2\x97\x86%s %sLOKI%s %s\xE2\x97\x8F%s %sAutonomi cockpit%s\n\n' \
+            "$b" "$p" "$nc" "$b" "$nc" "$t" "$nc" "$dim" "$nc" >&2
+    fi
+}
+
+# Print the rich handoff card and resolve the user's choice. Echoes exactly one
+# decision word on stdout:
+#   launch-bg           detach only
+#   launch-bg-dashboard detach + open the dashboard in a browser
+#   launch-bg-watch     detach + print the `loki cockpit` hint
+#   cancel              do not launch (user chose Stop)
+# All non-cancel decisions detach the build (arm --bg). The choice is remembered
+# per project under .loki/config/start-view.json; a remembered choice skips the
+# prompt and prints only a one-line summary.
+# Args: $1=spec label  $2=tier  $3=provider
+_loki_start_handoff() {
+    local spec="$1" tier="$2" prov="$3"
+    local port="${LOKI_DASHBOARD_PORT:-57374}"
+    local dash_url="http://127.0.0.1:${port}"
+    local budget="${LOKI_BUDGET_LIMIT:-none}"
+    local cfg_dir="${LOKI_DIR:-.loki}/config"
+    local cfg_file="$cfg_dir/start-view.json"
+    local pwd_path; pwd_path="$(pwd)"
+    local proj; proj="$(basename "$pwd_path")"
+
+    # Remembered choice: skip the prompt, print one-line summary, reuse decision.
+    local saved=""
+    if [ -f "$cfg_file" ]; then
+        saved="$(sed -n 's/.*"view"[[:space:]]*:[[:space:]]*"\([a-z-]*\)".*/\1/p' "$cfg_file" 2>/dev/null | head -1)"
+    fi
+    if [ -n "$saved" ]; then
+        case "$saved" in
+            both|dashboard|watch|detach)
+                echo -e "${DIM}Detaching to background (remembered view: ${saved}; change with 'loki cockpit' or delete ${cfg_file}).${NC}" >&2
+                case "$saved" in
+                    dashboard) echo "launch-bg-dashboard" ;;
+                    watch)     echo "launch-bg-watch" ;;
+                    *)         echo "launch-bg" ;;
+                esac
+                return 0
+                ;;
+        esac
+    fi
+
+    # Stare-worthy brand banner (S6) then the rich handoff card. Both to stderr so
+    # stdout carries only the decision word.
+    _loki_brand_banner "$proj"
+    {
+        echo -e "   ${BOLD}Building ${proj}${NC}  \033[38;2;31;197;168m\xE2\x97\x8F${NC} ${DIM}live${NC}"
+        echo ""
+        echo -e "   ${DIM}spec${NC}       ${spec}"
+        echo -e "   ${DIM}path${NC}       ${pwd_path}"
+        echo -e "   ${DIM}tier${NC}       ${tier}"
+        echo -e "   ${DIM}provider${NC}   ${prov}"
+        echo -e "   ${DIM}iteration${NC}  starting"
+        echo -e "   ${DIM}budget${NC}     \$0 / ${budget} (breaker: on)"
+        echo -e "   ${DIM}log${NC}        ${LOKI_DIR:-.loki}/logs/background-*.log"
+        echo -e "   ${DIM}dashboard${NC}  ${dash_url}"
+        echo ""
+        echo -e "   ${BOLD}Both${NC}[default]  ${BOLD}D${NC}ashboard  ${BOLD}W${NC}atch  De${BOLD}t${NC}ach  ${BOLD}S${NC}top"
+        echo -e "   ${DIM}opening your cockpit + dashboard in 8s -- press a key to choose${NC}"
+    } >&2
+
+    local reply=""
+    read -t 8 -r reply 2>/dev/null || reply=""
+
+    local decision="launch-bg" view="both"
+    case "$(printf '%s' "$reply" | tr '[:upper:]' '[:lower:]')" in
+        ""|b|both)          decision="launch-bg"; view="both" ;;
+        d|dash|dashboard)   decision="launch-bg-dashboard"; view="dashboard" ;;
+        w|watch)            decision="launch-bg-watch"; view="watch" ;;
+        t|detach)           decision="launch-bg"; view="detach" ;;
+        s|stop|cancel|q)    decision="cancel"; view="" ;;
+        *)                  decision="launch-bg"; view="both" ;;
+    esac
+
+    if [ "$decision" = "cancel" ]; then
+        echo -e "${YELLOW}run cancelled${NC}" >&2
+        echo "cancel"
+        return 0
+    fi
+
+    # Remember the choice for next time (best-effort; never blocks the launch).
+    mkdir -p "$cfg_dir" 2>/dev/null && \
+        printf '{"view":"%s"}\n' "$view" > "$cfg_file" 2>/dev/null || true
+
+    if [ "$view" = "both" ]; then
+        echo -e "${DIM}Open the dashboard at ${dash_url} or run 'loki cockpit' to watch.${NC}" >&2
+    elif [ "$view" = "watch" ]; then
+        echo -e "${DIM}Run 'loki cockpit' to watch the build.${NC}" >&2
+    fi
+
+    echo "$decision"
+    return 0
+}
+
 # Start Loki Mode
 cmd_start() {
     # First-run welcome (once): open the branded welcome page on the very
@@ -2316,6 +2481,41 @@ cmd_start() {
         loki_project_graph_discover "$_pg_target" || true
     fi
 
+    # S1: detach-to-background by default on an interactive TTY. Fires a rich,
+    # reversible handoff card, then arms the existing --bg path so run.sh
+    # backgrounds the runner (it writes the log + PID file and prints its own
+    # "Running in Background" banner). The HARD gate below keeps every
+    # non-interactive / --bg / --yes / CI caller on the exact pre-existing
+    # foreground exec -- byte-identical to before this change.
+    local _bg_already=""
+    for _a in ${args[@]+"${args[@]}"}; do
+        if [ "$_a" = "--bg" ]; then _bg_already=1; break; fi
+    done
+    if _loki_start_should_handoff "$_bg_already"; then
+        local _spec_label="${prd_file:-codebase (no PRD)}"
+        local _tier_label="${LOKI_COMPLEXITY:-auto}"
+        local _decision
+        _decision="$(_loki_start_handoff "$_spec_label" "$_tier_label" "$effective_provider")"
+        case "$_decision" in
+            cancel)
+                exit 0
+                ;;
+            launch-bg-dashboard|launch-bg)
+                # Both (default) AND Dashboard open the browser -- Both = dashboard
+                # + cockpit, honoring the card's "open dashboard" promise. The
+                # cockpit hint is printed by _loki_start_handoff for the Both path.
+                args+=("--bg")
+                local _du="http://127.0.0.1:${LOKI_DASHBOARD_PORT:-57374}"
+                if command -v open >/dev/null 2>&1; then open "$_du" >/dev/null 2>&1 &
+                elif command -v xdg-open >/dev/null 2>&1; then xdg-open "$_du" >/dev/null 2>&1 & fi
+                ;;
+            launch-bg-watch)
+                # Watch (cockpit only) detaches without opening the browser.
+                args+=("--bg")
+                ;;
+        esac
+    fi
+
     # v7.7.13 fix (user-reported bug): `"${args[@]}"` triggers "unbound
     # variable" under bash 3.2 (macOS default) + `set -u` when args is empty.
     # User report: `loki start` with no PRD on /Users/lokesh/git/anonima
@@ -8545,6 +8745,173 @@ cmd_watch() {
     esac
 }
 
+#===============================================================================
+# loki cockpit - Multi-repo live status as a terminal inline image (v7.126.0)
+#
+# Renders the Autonomi cockpit frame directly in supported terminals (iTerm2 /
+# WezTerm / ghostty via the iTerm2 protocol; Kitty via its graphics protocol).
+# On any unsupported terminal, or when rasterization is unavailable, it falls
+# back HONESTLY to a compact text summary and points at the browser dashboard.
+# This never touches `loki watch` (the PRD-file auto-rerun watcher).
+#===============================================================================
+
+# Compact honest text summary printed on the fallback path. Reads the same
+# CockpitState JSON the renderer would have used, so text and image agree.
+_cockpit_text_summary() {
+    local skill_dir="$1" focus_repo="$2"
+    local state_json
+    state_json="$(cockpit_gather_state "$skill_dir" "$focus_repo" 2>/dev/null || true)"
+    if [ -z "$state_json" ] || ! command -v python3 >/dev/null 2>&1; then
+        echo "  (no cockpit state available)"
+        return 0
+    fi
+    LOKI_CK_STATE="$state_json" python3 - <<'PYTXT' 2>/dev/null || echo "  (could not render text summary)"
+import json, os
+s = json.loads(os.environ.get("LOKI_CK_STATE") or "{}")
+print(f"  Run       {s.get('run','?')}")
+print(f"  Iteration {s.get('iteration',0)}   Phase {s.get('phase','?')}   Verdict {str(s.get('verdict','?')).upper()}")
+tier = s.get('tier') or '-'
+prov = s.get('provider') or '-'
+print(f"  Tier {tier}   Provider {prov}   Budget ${float(s.get('budgetUsd',0)):.2f}")
+gates = s.get('gates') or []
+if gates:
+    line = "  Gates     " + "  ".join(f"{g.get('name','?')}={g.get('status','?')}" for g in gates[:8])
+    print(line)
+council = s.get('council') or []
+if council:
+    print("  Council   " + "  ".join(f"{c.get('reviewer','?')}:{c.get('vote','?')}" for c in council[:6]))
+fleet = s.get('fleet') or []
+if fleet:
+    print(f"  Fleet ({len(fleet)}):")
+    for r in fleet[:8]:
+        mark = "*" if r.get("running") else " "
+        print(f"    {mark} {r.get('name','?'):<28} iter {r.get('iteration',0)}  {r.get('phase') or r.get('status') or ''}")
+PYTXT
+}
+
+cmd_cockpit() {
+    local protocol="auto"
+    local no_image="0"
+    local run_once="0"
+    local follow="1"
+    local interval="2"
+    local focus_repo=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h)
+                echo -e "${BOLD}loki cockpit${NC} - Live multi-repo status as a terminal inline image (v7.126.0)"
+                echo ""
+                echo "Usage: loki cockpit [options]"
+                echo ""
+                echo "Renders the Autonomi cockpit (iteration, phase, tier, provider, gates,"
+                echo "council votes, verdict, budget, and the multi-repo fleet) as an inline"
+                echo "image in supported terminals. Falls back to a text summary + the browser"
+                echo "dashboard on terminals without inline-image support."
+                echo ""
+                echo "Options:"
+                echo "  --once                 Render one frame then exit"
+                echo "  --follow               Re-render on an interval (default)"
+                echo "  --interval N           Seconds between frames in --follow (default: 2)"
+                echo "  --repo PATH            Focus one repo instead of the running fleet head"
+                echo "  --protocol P           iterm2 | kitty | auto (default: auto-detect)"
+                echo "  --no-image             Force the text/browser fallback"
+                echo "  --help, -h             Show this help"
+                echo ""
+                echo "Supported terminals: iTerm2, WezTerm, ghostty (iTerm2 protocol); Kitty."
+                echo "Override detection with LOKI_COCKPIT_PROTOCOL=iterm2|kitty."
+                echo ""
+                echo "Note: this is distinct from 'loki watch', which auto-reruns on PRD edits."
+                return 0
+                ;;
+            --once) run_once="1"; follow="0"; shift ;;
+            --follow) follow="1"; run_once="0"; shift ;;
+            --interval) interval="${2:-2}"; [ $# -ge 2 ] && shift 2 || shift ;;
+            --interval=*) interval="${1#*=}"; shift ;;
+            --repo) focus_repo="${2:-}"; [ $# -ge 2 ] && shift 2 || shift ;;
+            --repo=*) focus_repo="${1#*=}"; shift ;;
+            --protocol) protocol="${2:-auto}"; [ $# -ge 2 ] && shift 2 || shift ;;
+            --protocol=*) protocol="${1#*=}"; shift ;;
+            --no-image) no_image="1"; shift ;;
+            -*)
+                echo -e "${RED}Unknown option: $1${NC}"
+                echo "Run 'loki cockpit --help' for usage."
+                return 1
+                ;;
+            *)
+                if [ -z "$focus_repo" ]; then
+                    focus_repo="$1"
+                else
+                    echo -e "${RED}Unexpected argument: $1${NC}"
+                    return 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    # Load the render/gather helpers (pure logic lives in loki-ts).
+    local ts_dir="${_LOKI_SCRIPT_DIR}/../loki-ts"
+    local render_lib="${_LOKI_SCRIPT_DIR}/lib/cockpit-render.sh"
+    if [ -f "$render_lib" ]; then
+        # shellcheck disable=SC1090
+        source "$render_lib"
+    else
+        echo -e "${RED}cockpit render library not found${NC} ($render_lib)" >&2
+        return 1
+    fi
+
+    _cockpit_frame() {
+        local rc=0
+        # cockpit_render prints the terminal image to stdout on success (rc 0),
+        # or exits 3 (fallback) / 2 (bun unavailable). Capture stderr for the
+        # FALLBACK reason without swallowing the image bytes on stdout.
+        cockpit_render "$SKILL_DIR" "$ts_dir" "$protocol" "$no_image" "$focus_repo" 2>/tmp/loki-cockpit-err.$$ || rc=$?
+        if [ "$rc" = "0" ]; then
+            rm -f "/tmp/loki-cockpit-err.$$" 2>/dev/null
+            return 0
+        fi
+        # Honest fallback: text summary + browser dashboard pointer. NEVER claim
+        # an image was rendered here.
+        local reason=""
+        if [ -f "/tmp/loki-cockpit-err.$$" ]; then
+            reason="$(sed -n 's/^FALLBACK\t//p' "/tmp/loki-cockpit-err.$$" | head -1)"
+            rm -f "/tmp/loki-cockpit-err.$$" 2>/dev/null
+        fi
+        [ -z "$reason" ] && reason="inline image unavailable in this terminal"
+        echo ""
+        echo -e "${BOLD}Loki Cockpit${NC} ${DIM}(text fallback: ${reason})${NC}"
+        _cockpit_text_summary "$SKILL_DIR" "$focus_repo"
+        echo ""
+        echo -e "  Open the full visual dashboard: ${CYAN}loki dashboard${NC}"
+        return 3
+    }
+
+    if [ "$run_once" = "1" ]; then
+        _cockpit_frame
+        return 0
+    fi
+
+    # --follow (default): re-render until interrupted. On a fallback terminal we
+    # print the summary once (looping text is noise) and stop; on an image
+    # terminal we clear and redraw each interval.
+    local frame_rc=0
+    _cockpit_frame || frame_rc=$?
+    if [ "$frame_rc" != "0" ]; then
+        # Fallback path: no live image loop; the text summary + dashboard hint
+        # were already printed once. Point the user at --follow-capable UIs.
+        return 0
+    fi
+    # Image path: loop until Ctrl-C.
+    trap 'printf "\n"; return 0' INT
+    while :; do
+        sleep "$interval" 2>/dev/null || break
+        printf '\033[2J\033[H'   # clear + home before redraw
+        _cockpit_frame || break
+    done
+    return 0
+}
+
 #===============================================================================
 # loki export - Export session data (v6.0.0)
 #===============================================================================
@@ -17043,6 +17410,9 @@ main() {
         watch)
             cmd_watch "$@"
             ;;
+        cockpit)
+            cmd_cockpit "$@"
+            ;;
         export)
             # CLI consolidation (Phase A): 'export' -> 'report export'.
             _deprecated_alias export "report export" "$@"

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "7.125.0"
+__version__ = "7.126.0"
 
 # Expose the control app for easy import
 try: