cdx-manager 0.18.5 → 0.18.7

package/README.md

@@ -4,7 +4,7 @@
 
 <br clear="left"/>
 
-[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.18.5-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
+[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.18.7-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
 
 **Stop guessing which AI account still has quota.** `cdx` tracks the rate-limit window of every Codex and Claude account you own, tells you which one is usable right now, and launches it with isolated auth — in one command.
 
@@ -377,12 +377,13 @@ It is off by default because turning it on writes into the provider's own
 configuration and, on Codex, puts an approval prompt in front of you. That is
 not something to do to sessions you already own without being asked.
 
-Response previews are separately off by default. When enabled, a completion
-notification includes at most 180 characters of the agent's final response, and
-a permission request may quote the provider's own one-line description of what
-it wants to do. That text can be visible on a lock screen, so enable it only for
-sessions whose output is safe to expose. Previews never read transcripts, and
-the command a permission request is about is never included.
+New sessions inherit response previews when agent alerts were accepted during
+tray installation. A completion notification includes at most 180 characters
+of the agent's final response, and a permission request may quote the
+provider's own one-line description of what it wants to do. That text can be
+visible on a lock screen; disable it per session with
+`cdx set <name> --notify-preview off`. Previews never read transcripts, and the
+command a permission request is about is never included.
 
 Both providers are subscribed to the same two hooks: `Stop` when a turn ends and
 `PermissionRequest` when one blocks on your approval. Claude Code is also
@@ -465,6 +466,8 @@ Interactive launches and resumes set the terminal window title to `session — f
 
 The title is only written when stdout is a terminal. Nothing is emitted for `--json` launches, redirected or piped output, `cdx run` and other headless runs, login flows, or Ollama sessions. Session names and directories are stripped of escape and control characters before the title is emitted, and cdx does not restore the previous title when the session ends.
 
+Claude Code writes its own animated title while an action runs, and it redraws far more often than cdx re-asserts the shared title. So interactive Claude launches and resumes started by cdx set the Claude-specific `CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1` in the provider environment, which stops Claude from setting and clearing the title and leaves `session — folder` stable while Claude is busy. Claude's in-TUI activity indicator is unaffected, the value is forced so an ambient setting in your shell cannot hand the title back, and headless `cdx run`, Claude authentication flows, and every non-Claude provider keep their previous environment.
+
 ### Launch History
 
 Every interactive `cdx <name>` launch is recorded under `CDX_HOME`, including success/failure, duration, cwd, launch settings, and transcript path.
@@ -1046,6 +1049,10 @@ Without `--yes`, an interactive confirmation is required. `cdx` sends an idempot
 
 Contribution guidelines are available in [`CONTRIBUTING.md`](CONTRIBUTING.md).
 
+Working on the tray companion? [`docs/tray-local-testing.md`](docs/tray-local-testing.md)
+covers the local loops, from rendering the menu to stdout to running a real icon
+in the menu bar.
+
 ---
 
 ## License

package/VERSION

@@ -1 +1 @@
-0.18.5
+0.18.7

package/changelogs/CHANGELOGS_0_18_6.md

@@ -0,0 +1,8 @@
+# CDX Manager 0.18.6
+
+## Features
+
+- Launches can use an explicit `--dir`; each run records its directory for status and tray surfaces.
+- The Logics tray card derives repositories from active runs and shows basename-only rows.
+- `cdx update` names its install prefix, while `cdx tray doctor` reports the companion CDX command and hook-store alignment.
+- Windows Terminal, GNOME Terminal, and Konsole open new tabs where their documented interfaces support it; other terminals retain the working window fallback.

package/changelogs/CHANGELOGS_0_18_7.md

@@ -0,0 +1,5 @@
+# CDX Manager 0.18.7
+
+## Fixes
+
+- Interactive Claude sessions keep the cdx `session — folder` terminal title while Claude is running an action, instead of losing it to Claude's own animated title. Headless runs, Claude authentication flows, and other providers are unchanged.

package/checksums/release-archives.json

@@ -246,6 +246,28 @@
         "x86_64-pc-windows-msvc": "cc33c0f5a53472c6c1c72f458f33052abc09b6fe4ff5dfb5edae497c234bb2d0",
         "x86_64-unknown-linux-musl": "d8fb9958112329487bd91be7f7505f18f886676f4309e30aa3877340e42c6c15"
       }
+    },
+    "v0.18.5": {
+      "github_tarball_sha256": "d4251f1bdeb5aba31308cf749bf51733435bf2559f50a923ce090f0940c59876",
+      "github_zip_sha256": "36bc9d4e0a3cad306ccd405d7b4e4091418e21fe897b5ebcad4e275133615837",
+      "tray_assets": {
+        "aarch64-apple-darwin": "b0eb6653c3bbe1aba93d8b1966377e379eecea063ad01a10a11cdfd52d48e5ac",
+        "aarch64-unknown-linux-musl": "0cbca29099f1d320e917cb60e463fe0eb8fef9b78396db32520b8574ae4bb4a3",
+        "x86_64-apple-darwin": "a3e3d485552191f2456573dfbfee4259e430e7432b6d307eea00d5c527c86011",
+        "x86_64-pc-windows-msvc": "31a1743b0b6ec420a85c1679e93fcbd32c982a36e080a59d563276204682f152",
+        "x86_64-unknown-linux-musl": "49fba26d3deeab1e46af542528a5c71262e6c4d82898fcf989d7222a09a11d59"
+      }
+    },
+    "v0.18.6": {
+      "github_tarball_sha256": "31111eda2c31399b3fea14d80d10c0a2d10f15aab93a77a60939c86c564971ca",
+      "github_zip_sha256": "a3d78348416b3494645fa9f0467144c7e76b40d8862be959d125eb3d13805b15",
+      "tray_assets": {
+        "aarch64-apple-darwin": "aeb9267f72c3ee7426672d2e1fe98c0e39e0df795bbad6832299d4176c21022e",
+        "aarch64-unknown-linux-musl": "846969612d9a0e82f5f6cacc05aedc33153c1c325b8af95f63c8a2a5c2217261",
+        "x86_64-apple-darwin": "da5b4d3994fff9e616401e5a4cd01d68d216ddbeb6d41d96d67bbc789ef85118",
+        "x86_64-pc-windows-msvc": "296f760a7e10b7ef05936157b9de2b9d3b5e13f7ea2f57b7616705352ea97bd2",
+        "x86_64-unknown-linux-musl": "b360ea3ec14ab3aad0ccffcf477dee4bdadf6c1d4f150ef1cd13c7d293ae6829"
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdx-manager",
-  "version": "0.18.5",
+  "version": "0.18.7",
   "description": "Terminal session manager for Codex and Claude accounts.",
   "license": "MIT",
   "author": "Alexandre Agostini",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cdx-manager"
-version = "0.18.5"
+version = "0.18.7"
 description = "Terminal session manager for Codex and Claude accounts."
 readme = "README.md"
 requires-python = ">=3.9"

package/src/cli.py

@@ -619,8 +619,10 @@ def main(argv, options=None):
     if handler:
         return handler(rest, ctx)
 
-    if all(arg in ("--json", "-r", "--resume") for arg in rest):
-        return handle_launch(command, ctx, resume=("-r" in rest or "--resume" in rest))
+    from .commands.launch import _parse_launch_args
+    directory, launch_args = _parse_launch_args(rest)
+    if all(arg in ("--json", "-r", "--resume") for arg in launch_args):
+        return handle_launch(command, ctx, resume=("-r" in launch_args or "--resume" in launch_args), directory=directory)
 
     raise CdxError(f"Unknown command: {command}. Use cdx --help.")
 

package/src/cli_args.py

@@ -43,7 +43,7 @@ RESUME_USAGE = "Usage: cdx resume <name> [--json]"
 CAN_RESUME_USAGE = "Usage: cdx can-resume <name> [--json]"
 SELECT_USAGE = "Usage: cdx select --provider PROVIDER [--min-reasoning-effort minimal|low|medium|high|xhigh] [--min-power minimal|low|medium|high|xhigh] [--require-ready] [--refresh] --json"
 NEXT_USAGE = "Usage: cdx next [--json] [--refresh]"
-RUN_USAGE = "Usage: cdx run [session] --cwd PATH (--prompt-file PATH|--prompt TEXT|--prompt-file -) [--provider PROVIDER] [--model MODEL] [--kind assistant|code-review] [--reasoning-effort minimal|low|medium|high|xhigh] [--power minimal|low|medium|high|xhigh] [--permission review|default|auto|full|workspace-write|read-only|danger-full-access] [--timeout-seconds N] [--detach] [--failover] [--refresh] --json"
+RUN_USAGE = "Usage: cdx run [session] (--cwd|--dir) PATH (--prompt-file PATH|--prompt TEXT|--prompt-file -) [--provider PROVIDER] [--model MODEL] [--kind assistant|code-review] [--reasoning-effort minimal|low|medium|high|xhigh] [--power minimal|low|medium|high|xhigh] [--permission review|default|auto|full|workspace-write|read-only|danger-full-access] [--timeout-seconds N] [--detach] [--failover] [--refresh] --json"
 RUN_JSON_REQUIRED = "cdx run: --json is required."
 RUN_TARGET_REQUIRED = "cdx run: specify a session name or --provider PROVIDER."
 RUN_SESSION_PROVIDER_CONFLICT = "cdx run: cannot specify both a session name and --provider."
@@ -585,6 +585,7 @@ def _parse_run_effort(reasoning_effort, power):
 def _parse_run_args(args):
     parsed = _parse_run_flag_args(args, {
         "--cwd": {"key": "cwd", "type": "str", "default": None},
+        "--dir": {"key": "cwd", "type": "str", "default": None},
         "--prompt-file": {"key": "prompt_file", "type": "str", "default": None},
         "--prompt": {"key": "prompt", "type": "str", "default": None},
         "--provider": {"key": "provider", "type": "str", "default": None, "transform": _parse_run_provider},

package/src/commands/launch.py

@@ -28,6 +28,54 @@ from ..errors import CdxError
 from ..provider_runtime import _ensure_session_authentication, _get_auth_home, _run_interactive_provider_command
 
 
+def _parse_launch_args(args):
+    """Return the per-launch directory and ordinary launch flags."""
+    directory = None
+    cleaned = []
+    index = 0
+    while index < len(args):
+        arg = args[index]
+        if arg == "--dir":
+            if directory is not None or index + 1 >= len(args):
+                raise CdxError("Usage: cdx <name> [--dir PATH] [--resume] [--json]")
+            directory = args[index + 1]
+            index += 2
+            continue
+        if arg.startswith("--dir="):
+            if directory is not None or not arg.split("=", 1)[1]:
+                raise CdxError("Usage: cdx <name> [--dir PATH] [--resume] [--json]")
+            directory = arg.split("=", 1)[1]
+            index += 1
+            continue
+        cleaned.append(arg)
+        index += 1
+    return directory, cleaned
+
+
+def _launch_directory(session, ctx, explicit, json_flag):
+    cwd = os.path.realpath(explicit) if explicit else (ctx.get("cwd") or os.getcwd())
+    if explicit and not os.path.isdir(cwd):
+        raise CdxError(f"Invalid directory: {explicit or cwd}")
+    if explicit or json_flag or not ctx["stdin_is_tty"] or cwd not in {os.path.realpath(os.path.expanduser("~")), os.path.realpath(os.path.sep)}:
+        return cwd
+    recent = []
+    for entry in ctx["service"]["get_launch_history"](session["name"], limit=20):
+        path = entry.get("cwd")
+        if path and os.path.isdir(path) and path not in recent:
+            recent.append(path)
+    choices = recent + [cwd]
+    if len(choices) == 1:
+        return cwd
+    ctx["out"]("Choose launch directory:\n" + "".join(f"  {index + 1}. {path}\n" for index, path in enumerate(choices)))
+    answer = (ctx["options"].get("input") or input)(f"Directory [1-{len(choices)}] (default {len(choices)}): ").strip()
+    if not answer:
+        return cwd
+    try:
+        return choices[int(answer) - 1]
+    except (ValueError, IndexError):
+        raise CdxError("Launch cancelled: choose a listed directory.") from None
+
+
 def _format_resume_capability(capability, use_color=False):
     name = capability["session"]
     provider = capability["provider"]
@@ -74,12 +122,13 @@ def handle_can_resume(rest, ctx):
     return 0
 
 def handle_resume(rest, ctx):
+    directory, rest = _parse_launch_args(rest)
     json_flag, args = _parse_json_flag(rest)
     if len(args) != 1:
         raise CdxError(RESUME_USAGE)
-    return handle_launch(args[0], ctx, resume=True, force_json=json_flag)
+    return handle_launch(args[0], ctx, resume=True, force_json=json_flag, directory=directory)
 
-def handle_launch(command, ctx, initial_prompt=None, resume=False, force_json=None):
+def handle_launch(command, ctx, initial_prompt=None, resume=False, force_json=None, directory=None):
     json_flag = "--json" in ctx.get("raw_args", ctx["options"].get("raw_args", []))
     if force_json is not None:
         json_flag = force_json
@@ -91,6 +140,9 @@ def handle_launch(command, ctx, initial_prompt=None, resume=False, force_json=No
         raise CdxError(
             f"Provider {session['provider']} does not support native resume through cdx."
         )
+    cwd = _launch_directory(session, ctx, directory, json_flag)
+    if not json_flag and not ctx["stdin_is_tty"]:
+        ctx["out"](f"Using directory: {cwd}\n")
     _ensure_session_authentication(
         session,
         ctx["service"],
@@ -127,13 +179,12 @@ def handle_launch(command, ctx, initial_prompt=None, resume=False, force_json=No
             # a real turn — so it gets no instruction it does not need.
             notice += " — approve them once in Codex to enable"
         ctx["out"](f"{_info(notice, ctx['use_color'])}\n")
-    cwd = ctx.get("cwd") or os.getcwd()
     runtime_run_id = None
 
     def runtime_lifecycle(event, info):
         nonlocal runtime_run_id
         if event == "started":
-            runtime = ctx["service"]["start_session_runtime"](session["name"], info)
+            runtime = ctx["service"]["start_session_runtime"](session["name"], {**info, "cwd": cwd})
             runtime_run_id = runtime.get("runId")
         elif event == "finished" and runtime_run_id:
             ctx["service"]["finish_session_runtime"](
@@ -176,7 +227,7 @@ def handle_launch(command, ctx, initial_prompt=None, resume=False, force_json=No
         **run_info,
     })
     if json_flag:
-        extra = {"session": ctx["service"]["get_session"](session["name"])}
+        extra = {"session": ctx["service"]["get_session"](session["name"]), "cwd": cwd}
         if capability:
             extra["resume"] = capability
         _write_json(ctx, _json_success("resume" if resume else "launch", message, warnings=warnings, **extra))

package/src/commands/maintenance.py

@@ -774,10 +774,12 @@ def handle_update(rest, ctx):
             current_version=current_version,
             target_version=target_version,
             mode=plan["mode"],
+            prefix=plan["prefix"],
             steps=results,
         ))
         return 0
     ctx["out"](f"{_success(message, ctx['use_color'])}\n")
+    ctx["out"](f"Install prefix: {plan['prefix']}\n")
     for warning in warnings:
         ctx["out"](f"{_warn(warning['message'], ctx['use_color'])}\n")
     return 0

package/src/commands/settings.py

@@ -58,6 +58,7 @@ def _notification_setting_notice(settings, sessions, action):
             notices.append(f"Agent alerts updated for {names} — this provider does not support notification hooks.")
         return "\n".join(notices)
     if "notify_preview" in settings:
+        names = _format_bulk_launch_summary(sessions)
         if action == "set" and settings["notify_preview"]:
             return f"Response previews enabled for {names} — completion text may be visible on the lock screen."
         return f"Response previews disabled for {names}."

package/src/commands/tray.py

@@ -5,12 +5,14 @@ and `autostart` act on recorded state and say plainly when there is none, and
 `doctor` reads all of it without changing any of it.
 """
 import os
+import shutil
 import subprocess
 from datetime import datetime, timezone
 
 from ..cli_args import TRAY_USAGE, _parse_flag_args
 from ..cli_helpers import _json_success, _write_json
 from ..cli_render import _dim, _pad_table, _style, _warn
+from ..config import get_cdx_home
 from ..errors import CdxError
 from ..tray_alerts import alerts_enabled, set_alerts
 from ..tray_autostart import disable as autostart_disable
@@ -127,6 +129,7 @@ def _tray_status(args, ctx):
         ctx["service"]["base_dir"],
         env=ctx.get("env"),
         cache=None if parsed["refresh"] else _plugin_cache(ctx),
+        directories=[row.get("cwd") for row in rows if row.get("active") and row.get("cwd")],
     )
     snapshot = build_snapshot(
         rows,
@@ -591,6 +594,8 @@ def _tray_doctor(args, ctx):
     instance = companion_instance(env=env)
     desktop = desktop_capability(env=env)
     toasts = toast_capability(env=env)
+    companion_cdx = (env or {}).get("CDX_TRAY_CDX") or shutil.which("cdx", path=(env or {}).get("PATH")) or "cdx"
+    hook_store = get_cdx_home(env)
 
     checks = [
         ("companion", "installed" if state else ("override" if executable else "absent"),
@@ -608,6 +613,8 @@ def _tray_doctor(args, ctx):
         ("autostart", "on" if autostart["enabled"] else "off", autostart["artifact"] or "unsupported"),
         ("alerts", "on" if alerts_enabled(base_dir) else "muted",
          "cdx tray alerts on|off"),
+        ("companion_cdx", "override" if (env or {}).get("CDX_TRAY_CDX") else "path", companion_cdx),
+        ("hook_store", "aligned" if os.path.realpath(hook_store) == os.path.realpath(base_dir) else "mismatched", hook_store),
         ("update", "interrupted" if interrupted_update(base_dir) else "clean",
          "a staged companion was never promoted; run: cdx tray install"
          if interrupted_update(base_dir) else "-"),

package/src/provider_runtime.py

@@ -108,6 +108,9 @@ def headless_permission_disables_network(provider, permission):
 
 
 REDACTED_PROMPT_ARG = "[prompt redacted]"
+# Documented Claude Code switch that stops it from setting and clearing the
+# terminal title, leaving cdx's shared title keeper as the only writer.
+CLAUDE_DISABLE_TERMINAL_TITLE_ENV = "CLAUDE_CODE_DISABLE_TERMINAL_TITLE"
 CLAUDE_CLI_MODEL_ALIASES = {
     "claude-sonnet": "sonnet",
     "claude-opus": "opus",
@@ -148,11 +151,23 @@ def _anthropic_credentials_path(auth_home):
     return os.path.join(auth_home, "credentials", f"{_anthropic_profile_name()}.json")
 
 
-def _claude_env(base_env, auth_home):
+def _claude_env(base_env, auth_home, own_terminal_title=False):
+    """Build the Claude provider environment for one cdx spawn.
+
+    `own_terminal_title` is set by the interactive launch/resume paths, where
+    cdx's title keeper owns the `session — folder` title. Claude Code redraws an
+    animated busy title far more often than the keeper re-emits, so we tell it
+    to leave the title alone; its in-TUI activity indicator is unaffected. The
+    value is forced rather than defaulted so an ambient `0` in the operator's
+    shell cannot hand the title back to Claude. Headless and auth spawns do not
+    own a title and keep their previous environment.
+    """
     env = {**base_env, **_home_env_overrides(auth_home)}
     env.pop("CLAUDE_CONFIG_DIR", None)
     env.pop("CODEX_HOME", None)
     env.setdefault("ANTHROPIC_PROFILE", _anthropic_profile_name())
+    if own_terminal_title:
+        env[CLAUDE_DISABLE_TERMINAL_TITLE_ENV] = "1"
     return env
 
 
@@ -547,7 +562,7 @@ def _build_launch_spec(session, cwd=None, env_override=None, initial_prompt=None
         if initial_prompt:
             args.append(initial_prompt)
         auth_home = _get_auth_home(session)
-        claude_env = _claude_env(env, auth_home)
+        claude_env = _claude_env(env, auth_home, own_terminal_title=True)
         oauth_token = _read_claude_launch_oauth_token(auth_home)
         if oauth_token:
             claude_env["CLAUDE_CODE_OAUTH_TOKEN"] = oauth_token
@@ -693,7 +708,7 @@ def _build_resume_spec(session, cwd=None, env_override=None, capture_transcript=
         if resume_prompt:
             args.append(resume_prompt)
         auth_home = _get_auth_home(session)
-        claude_env = _claude_env(env, auth_home)
+        claude_env = _claude_env(env, auth_home, own_terminal_title=True)
         oauth_token = _read_claude_launch_oauth_token(auth_home)
         if oauth_token:
             claude_env["CLAUDE_CODE_OAUTH_TOKEN"] = oauth_token

package/src/session_service.py

@@ -629,6 +629,7 @@ def _launch_defaults_for(base_dir, provider):
     try:
         if supports_agent_alerts(provider) and alerts_default(base_dir):
             launch["notify"] = True
+            launch["notify_preview"] = True
     except OSError:
         # An unreadable default is no default. Creating the session matters
         # more than inheriting a preference.
@@ -739,6 +740,7 @@ def start_session_runtime(store, name, payload=None):
         "pid": payload.get("pid") or os.getpid(),
         "command": payload.get("command"),
         "label": payload.get("label"),
+        "cwd": payload.get("cwd"),
         "transcriptPath": payload.get("transcript_path") or payload.get("transcriptPath"),
     }
 

package/src/session_status.py

@@ -268,6 +268,7 @@ def _status_row_from_session(store, s):
     status = s.get("lastStatus")
     enabled = s.get("enabled", True) is not False
     row_status = status if enabled else None
+    runtime = _session_runtime(store, s["name"])
     return {
         "session_name": s["name"],
         "label": s.get("label"),
@@ -279,7 +280,8 @@ def _status_row_from_session(store, s):
         # ignored `--priority` entirely.
         "priority": _row_priority(s),
         "reasoning_effort": _row_reasoning_effort(s),
-        "active": bool(_session_runtime(store, s["name"])) if enabled else False,
+        "active": bool(runtime) if enabled else False,
+        "cwd": runtime.get("cwd") if runtime else None,
         "status": "enabled" if enabled else "disabled",
         "auth_status": (s.get("auth") or {}).get("status") or "unknown",
         "auth_checked_at": _to_local_iso((s.get("auth") or {}).get("lastCheckedAt")),
@@ -313,6 +315,7 @@ def format_list_rows(store):
         "provider": s["provider"] if has_multiple else None,
         "enabled": s.get("enabled", True) is not False,
         "active": bool(_session_runtime(store, s["name"])) if s.get("enabled", True) is not False else False,
+        "cwd": (_session_runtime(store, s["name"]) or {}).get("cwd"),
         "enabled_status": "disabled" if s.get("enabled", True) is False else "enabled",
         "status": s.get("lastStatus"),
         "launch": s.get("launch") or {},

package/src/tray_logics.py

@@ -12,6 +12,7 @@ task, because it is what to do instead. A tray menu that listed everything would
 be a worse `logics-manager status`, run more often.
 """
 import json
+import os
 import subprocess
 import time
 
@@ -21,7 +22,7 @@ from .tray_plugins import ADAPTER_TIMEOUT_SECONDS, CARD_TTL_SECONDS
 _PRIORITY_ORDER = {"high": 0, "medium": 1, "low": 2}
 
 
-def logics_card(env=None, now=None, cache=None, runner=None, executable=None):
+def logics_card(env=None, now=None, cache=None, runner=None, executable=None, directories=None):
     """One card, or None when there is nothing truthful to show.
 
     None covers every unhappy case on purpose — not installed, not a Logics
@@ -33,7 +34,7 @@ def logics_card(env=None, now=None, cache=None, runner=None, executable=None):
     cached = _from_cache(cache, now)
     if cached is not None:
         return cached
-    status = _status(env=env, runner=runner, executable=executable)
+    status = _status(env=env, runner=runner, executable=executable, directories=directories)
     card = _card_from_status(status)
     _to_cache(cache, now, card)
     return card
@@ -58,7 +59,16 @@ def _to_cache(cache, now, card):
         cache["logics"] = {"at": now, "card": card}
 
 
-def _status(env=None, runner=None, executable=None):
+def _repository_root(directory):
+    directory = os.path.realpath(directory or "")
+    while directory and directory != os.path.dirname(directory):
+        if os.path.exists(os.path.join(directory, ".git")):
+            return directory
+        directory = os.path.dirname(directory)
+    return directory if os.path.exists(os.path.join(directory, ".git")) else None
+
+
+def _status(env=None, runner=None, executable=None, directories=None):
     """`logics-manager status --format json`, or None however it failed.
 
     Resolved through CDX's own lookup rather than a path the tray knows: on a
@@ -68,26 +78,38 @@ def _status(env=None, runner=None, executable=None):
     executable = executable or resolve_logics_manager(env or {})
     if not executable:
         return None
-    try:
-        completed = (runner or subprocess.run)(
-            [executable, "status", "--format", "json"],
-            capture_output=True,
-            text=True,
-            timeout=ADAPTER_TIMEOUT_SECONDS,
-            check=False,
-        )
-    except (OSError, subprocess.SubprocessError):
-        return None
-    if getattr(completed, "returncode", 1) != 0:
-        return None
-    try:
-        payload = json.loads(completed.stdout)
-    except (TypeError, ValueError):
+    roots = sorted({root for root in (_repository_root(path) for path in (directories or [])) if root})
+    if directories is not None and not roots:
         return None
-    return payload if isinstance(payload, dict) else None
+    payloads = []
+    for root in roots or [None]:
+        try:
+            completed = (runner or subprocess.run)(
+                [executable, "status", "--format", "json"], capture_output=True,
+                text=True, timeout=ADAPTER_TIMEOUT_SECONDS, check=False, **({"cwd": root} if root else {}),
+            )
+            payload = json.loads(completed.stdout) if getattr(completed, "returncode", 1) == 0 else None
+        except (OSError, subprocess.SubprocessError, TypeError, ValueError):
+            return None if not payloads else payloads
+        if isinstance(payload, dict):
+            payloads.append((root, payload))
+    return payloads if roots else (payloads[0][1] if payloads else None)
 
 
 def _card_from_status(status):
+    if isinstance(status, list):
+        cards = [(root, _card_from_status(payload), len(payload.get("blocked_docs") or [])) for root, payload in status]
+        cards = [(root, card, blocked) for root, card, blocked in cards if card]
+        if not cards:
+            return None
+        root, card, _ = sorted(cards, key=lambda item: (-item[2], -len(item[1]["rows"]), item[0] or ""))[0]
+        repository_count = len(cards)
+        blocked_count = sum(item[2] for item in cards)
+        card["summary"] = f"{repository_count} repositories · {blocked_count} blocked"
+        prefix = os.path.basename(root or "")
+        for row in card["rows"]:
+            row["label"] = f"{prefix}: {row['label']}"
+        return card
     if not isinstance(status, dict):
         return None
     blocked = [doc for doc in (status.get("blocked_docs") or []) if isinstance(doc, dict)]

package/src/tray_plugins.py

@@ -128,7 +128,7 @@ def _valid_action(action, plugin):
     )
 
 
-def collect_cards(base_dir, env=None, now=None, adapters=None, cache=None):
+def collect_cards(base_dir, env=None, now=None, adapters=None, cache=None, directories=None):
     """Every enabled plugin's card, bounded, with failures dropped.
 
     Never raises. An adapter that throws, hangs past its timeout, returns
@@ -143,7 +143,7 @@ def collect_cards(base_dir, env=None, now=None, adapters=None, cache=None):
         if not adapter:
             continue
         try:
-            raw = adapter(env=env, now=now, cache=cache)
+            raw = adapter(env=env, now=now, cache=cache, directories=directories) if name == "logics" else adapter(env=env, now=now, cache=cache)
         except Exception:  # noqa: BLE001 - an integration cannot break the tray
             continue
         card = bounded_card(raw, name)
@@ -152,10 +152,10 @@ def collect_cards(base_dir, env=None, now=None, adapters=None, cache=None):
     return cards
 
 
-def _logics_adapter(env=None, now=None, cache=None):
+def _logics_adapter(env=None, now=None, cache=None, directories=None):
     from .tray_logics import logics_card
 
-    return logics_card(env=env, now=now, cache=cache)
+    return logics_card(env=env, now=now, cache=cache, directories=directories)
 
 
 # The registry. A name here is the only way an adapter can run, and adding one

package/src/update_manager.py

@@ -171,6 +171,7 @@ def build_update_plan(target_version=None, package_root=None, env=None, prefix=N
     return {
         "mode": mode,
         "package_root": str(root),
+        "prefix": str(prefix or sys.prefix),
         "target_version": version,
         "steps": steps,
     }