cdx-manager 0.9.15 → 0.10.0

package/README.md

@@ -1,6 +1,6 @@
 # CDX Manager
 
-[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.9.15-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.10.0-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
 
 **Run multiple Codex, Claude, Antigravity, and Ollama sessions from one terminal. Switch between accounts instantly.**
 
@@ -41,10 +41,12 @@ One command to launch any session. Zero auth juggling.
 - **Session control.** Disable a session without deleting it when an account is temporarily out of credits; disabled sessions remain visible and sort last.
 - **Persistent launch settings.** Pin per-session power, permission, and fast-mode preferences once; `cdx` reapplies them on every launch until you unset them.
 - **Launch history.** Inspect recent launches with provider, result, duration, working directory, launch settings, and transcript path.
+- **Disk usage and cleanup.** `cdx disk` reports `CDX_HOME` usage, `cdx disk profiles --candidates` identifies reclaimable profile caches/logs with evidence, and `cdx clean profiles ...` applies explicit cleanup actions.
 - **Update prompts.** Periodic update checks surface `cdx update` directly in the `cdx`, `cdx status`, and launch output when a newer release is available. When `logics-manager` is installed, `cdx` can also suggest `logics-manager self-update`.
 - **Logics viewer shortcut.** `cdx view` opens the Logics browser/focus viewer through `logics-manager view` when the companion CLI is installed. All viewer flags are forwarded: `--lan`, `--lan-rw`, `--focus <ref>`, `--read`, `--port`, `--host`, `--refresh-interval`, `--tls`, `--tls-cert`, `--tls-key`, `--open`, `--no-open`. `cdx view --json` reports availability and update diagnostics without opening the viewer.
 - **Shared handoff context.** Keep a per-workspace Markdown context, or build one from a source session transcript, and install it into another assistant session before switching providers or accounts.
 - **Passive status resolution.** Codex status is read from the local Codex app-server rate-limit API when available, with legacy transcript/history parsing kept as a fallback.
+- **Banked reset visibility.** Eligible Codex accounts show the number of manually redeemable bonus resets in `cdx status` and expose reset details in JSON output.
 - **Session transcript capture.** Every launch is recorded to a local log file via `script`, giving you a full terminal transcript for each session.
 - **Clean removal.** `cdx rmv` wipes a session and its entire auth directory. No orphaned files, no stale credentials.
 
@@ -265,6 +267,10 @@ cdx next
 
 # Notify when the next cooling-down assistant is ready
 cdx ready
+
+# Inspect CDX_HOME and profile disk usage
+cdx disk
+cdx disk profiles --candidates
 ```
 
 ### Next-Ready Notifications
@@ -358,7 +364,10 @@ cdx history --summary --from 2026-05-01 --to 2026-05-28
 | `cdx handoff <name> [--json]` | Install the current workspace context into a target session and launch it unless `--json` is used |
 | `cdx handoff <source> <target> [--json]` | Build shared context from the source session's latest launch transcript, install it into the target session, and launch the target unless `--json` is used; supports cross-provider handoff |
 | `cdx rmv <name> [--force] [--json]` | Remove a session and its auth data (prompts for confirmation unless `--force`) |
-| `cdx clean [name] [--json]` | Clear launch transcript logs for one session or all sessions |
+| `cdx clean [name] [--yes] [--json]` | Clear launch transcript logs for one session or all sessions after confirmation |
+| `cdx clean profiles (--tmp\|--old-logs DAYS) [--yes] [--json]` | Remove explicit profile cleanup candidates after confirmation: temporary marketplace/plugin staging caches or old `.log` files |
+| `cdx disk [profiles] [--candidates] [--json]` | Measure `CDX_HOME`; `profiles` includes per-profile breakdown, and `--candidates` reports reclaimable temporary caches and old logs with evidence |
+| `cdx reset <name> [--yes] [--json]` | Explicitly consume one available banked Codex rate-limit reset; confirmation is required unless `--yes` is supplied |
 | `cdx export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR\|--passphrase-stdin] [--force] [--json]` | Export sessions to a portable bundle; `--include-auth` encrypts auth data with a passphrase |
 | `cdx import <file> [--sessions a,b] [--passphrase-env VAR\|--passphrase-stdin] [--force] [--json]` | Import sessions from a bundle into the current `CDX_HOME` |
 | `cdx doctor [--json]` | Inspect CLI dependencies, CDX_HOME permissions, missing state, orphan profiles, and pending quarantines |
@@ -394,6 +403,8 @@ Commands with machine-readable output:
 - `cdx ren ... --json`
 - `cdx rmv ... --json`
 - `cdx clean ... --json`
+- `cdx disk ... --json`
+- `cdx reset ... --json`
 - `cdx export ... --json`
 - `cdx import ... --json`
 - `cdx login ... --json`
@@ -602,7 +613,68 @@ All session data lives under `CDX_HOME` (default: `~/.cdx/`):
           cdx-session.log
 ```
 
-Session names are URL-encoded when used as directory or file names. CLI command names such as `add`, `status`, and `login` are reserved and cannot be used as session names.
+Session names are URL-encoded when used as directory or file names. CLI command names such as `add`, `disk`, `status`, and `login` are reserved and cannot be used as new session names.
+
+### Disk maintenance
+
+Use `cdx disk` for a total `CDX_HOME` measurement, and `cdx disk profiles` for the `profiles/` total plus a per-profile breakdown.
+
+In an interactive terminal, long scans report their current stage and per-profile progress on stderr. JSON and redirected output remain free of progress messages.
+
+Text output uses aligned summary tables with profile size, share of total space, and reclaimable space. Candidate details are grouped by profile with separate size, type, risk, and evidence columns.
+
+```bash
+cdx disk
+cdx disk profiles
+```
+
+To find cleanup candidates without deleting anything:
+
+```bash
+cdx disk profiles --candidates
+cdx disk profiles --candidates --json
+```
+
+Candidate evidence includes profile name, path, size, risk, reason, and metadata such as modified time or old-log file counts. The current cleanup candidates are intentionally limited to:
+
+- temporary marketplace/plugin staging caches under `profiles/*/.tmp/`
+- `.log` files older than the requested age inside profile `log/` directories
+
+`cdx` also runs a passive disk cleanup check at most once per day on advisory commands such as `cdx` and `cdx status`. It writes the check timestamp and latest measurements to `~/.cdx/state/disk-cleanup-check.json`. A warning is shown only when at least one threshold is met:
+
+- `CDX_HOME` uses 10 GB or more
+- cleanup candidates can reclaim 1 GB or more
+- temporary cache candidates can reclaim 500 MB or more
+- old log candidates can reclaim 500 MB or more
+- one profile is 2 GB or more, or one profile is at least 25% of `profiles/` when `profiles/` is already 1 GB or more
+
+The passive warning is read-only and points to `cdx disk profiles --candidates`; it never deletes files.
+
+Apply cleanup only with explicit actions:
+
+```bash
+cdx clean profiles --tmp
+cdx clean profiles --old-logs 30d
+```
+
+`--tmp` removes temporary marketplace/plugin clone/backup staging directories. `--old-logs 30d` removes only `.log` files older than 30 days. The commands do not remove `auth.json`, `config.toml`, `sessions/`, SQLite state, installed `plugins/`, `skills/`, or credentials.
+
+All `cdx clean` actions require interactive confirmation before any deletion or log truncation begins. Non-interactive scripts must pass `--yes` explicitly.
+
+The cleanup action is selected only when `--tmp` or `--old-logs` is present. This keeps `cdx clean profiles` available for an existing session named `profiles`. If any candidate or old log cannot be removed, cleanup stops with a non-zero error that identifies the affected path; it does not report the operation as successful.
+
+### Banked Codex resets
+
+Eligible Codex accounts expose manually redeemable rate-limit resets through the Codex app-server. `cdx status` shows their available count in the `RESETS` column; `cdx status <name>` also shows the nearest known expiration, and JSON status includes the available reset details supplied by Codex.
+
+Activation is always explicit:
+
+```bash
+cdx reset <name>
+cdx reset <name> --yes --json
+```
+
+Without `--yes`, an interactive confirmation is required. `cdx` sends an idempotency key, consumes at most one available reset, and refreshes the session status after a successful activation. It never activates a reset from `cdx status` or any background check.
 
 ---
 

package/changelogs/CHANGELOGS_0_10_0.md

@@ -0,0 +1,43 @@
+# CDX Manager 0.10.0
+
+## Highlights
+
+- Inspect `CDX_HOME` and per-profile disk usage with readable, progress-aware reports.
+- Find evidence-backed cleanup candidates and reclaim space through confirmed actions.
+- Display and explicitly activate banked Codex rate-limit resets.
+
+## Changes
+
+### Disk usage and cleanup
+
+`cdx disk` measures total `CDX_HOME` usage. `cdx disk profiles` adds an aligned per-profile table with size and share of total space, while `--candidates` adds reclaimable totals and evidence grouped by profile.
+
+Interactive scans report their current stage and profile count on stderr so large profiles no longer appear stalled. JSON and redirected output remain unchanged.
+
+Cleanup candidates are intentionally limited to temporary marketplace/plugin staging directories and old `.log` files. `cdx clean profiles --tmp` and `cdx clean profiles --old-logs DAYS` require confirmation before deletion; all other `cdx clean` log-truncation actions now require confirmation as well. Non-interactive automation must opt in with `--yes`.
+
+A passive read-only check runs at most once per day and warns when documented total, reclaimable, category, or large-profile thresholds are reached. It never removes files automatically.
+
+### Banked Codex resets
+
+Eligible Codex accounts now show banked rate-limit reset counts in `cdx status`. Detailed JSON includes reset identifiers, labels, grant timestamps, and expiration timestamps when Codex provides them.
+
+`cdx reset <name>` consumes one reset through Codex's idempotent reset-credit endpoint, requires confirmation unless `--yes` is supplied, and refreshes status after activation. Status checks never consume resets automatically.
+
+### Compatibility and safeguards
+
+`disk` and `reset` are reserved for new session names. Existing sessions named `profiles` remain compatible with `cdx clean profiles`; profile-wide cleanup is selected only when `--tmp` or `--old-logs` is present.
+
+Cleanup failures now stop with a non-zero error naming the affected path instead of silently reporting zero bytes removed.
+
+## Validation
+
+- `npm run release:validate`
+- `npm run lint`
+- `npm test`
+- `logics-manager lint --require-status`
+- `logics-manager audit`
+- `git diff --check`
+- `npm --cache /private/tmp/cdx-npm-cache pack --dry-run`
+- `python -m build`
+- `python -m twine check dist/*`

package/changelogs/CHANGELOGS_0_9_16.md

@@ -0,0 +1,19 @@
+# CDX Manager 0.9.16
+
+## Highlights
+
+- Clear error message when a provider CLI binary is broken instead of a raw Python traceback.
+
+## Changes
+
+### Friendlier auth probe failures
+
+Launching a session whose provider CLI exists but cannot be executed (corrupted install, wrong architecture, or a script missing its shebang — e.g. `Exec format error` on `~/.local/bin/claude`) previously crashed with an unhandled `OSError` traceback. The auth probe now catches all `OSError` failures and reports an actionable message telling the user to reinstall the provider CLI, exiting with code 126.
+
+## Validation
+
+- `npm run release:validate`
+- `npm run lint`
+- `npm test`
+- `git diff --check`
+- `npm --cache /private/tmp/cdx-npm-cache pack --dry-run`

package/checksums/release-archives.json

@@ -124,6 +124,14 @@
     "v0.9.14": {
       "github_tarball_sha256": "5469be5448eee56b5f0834d0c42d9ed3ca088158f08052bd8addc552635fe33d",
       "github_zip_sha256": "7eb5650cb348e3ef2a082cd7fb39d7f4c170d4a095fe88719a7ebbfb7601db48"
+    },
+    "v0.9.15": {
+      "github_tarball_sha256": "08e6c5a3459fdd65d1f6085ca03a3614f07b4bf44c57a995a3ef47446aa70482",
+      "github_zip_sha256": "c8ac01f4a65e85b417f5eba5139868ab17b8f0952bf99f17f0a79f73ef0f36d6"
+    },
+    "v0.9.16": {
+      "github_tarball_sha256": "0876509c201485824f6e5fe7b4a96ceb41cc68279fbe6dda4891864cf5be93ec",
+      "github_zip_sha256": "08072957a0421d257cecfa8bed73cceee80d1c8857c59ac45378ac8ce3e0362d"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdx-manager",
-  "version": "0.9.15",
+  "version": "0.10.0",
   "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.9.15"
+version = "0.10.0"
 description = "Terminal session manager for Codex and Claude accounts."
 readme = "README.md"
 requires-python = ">=3.9"

package/src/cli.py

@@ -3,10 +3,14 @@
 import json
 import os
 import sys
+from datetime import datetime, timezone
 
 from .cli_commands import (
     API_SCHEMA_VERSION,
     STATUS_USAGE,
+    _collect_profile_cleanup_candidates,
+    _directory_child_sizes,
+    _directory_size_bytes,
     handle_add,
     handle_can_resume,
     handle_clean,
@@ -15,6 +19,7 @@ from .cli_commands import (
     handle_context,
     handle_copy,
     handle_disable,
+    handle_disk,
     handle_doctor,
     handle_enable,
     handle_export,
@@ -31,6 +36,7 @@ from .cli_commands import (
     handle_remove,
     handle_rename,
     handle_repair,
+    handle_reset,
     handle_resume,
     handle_run,
     handle_run_report,
@@ -44,6 +50,9 @@ from .cli_commands import (
     handle_update,
     handle_view,
 )
+from .cli_commands import (
+    _format_bytes as _format_disk_bytes,
+)
 from .cli_render import (
     _format_sessions,
     _pad_table,
@@ -66,7 +75,7 @@ from .status_view import (
 )
 from .update_check import check_for_update, check_logics_manager_for_update
 
-VERSION = "0.9.15"
+VERSION = "0.10.0"
 
 # Public surface: this module is a facade. Names below are imported above
 # purely to be re-exported (consumed by tests and external callers); listing
@@ -94,6 +103,7 @@ _COMMAND_HANDLERS = {
     "config": handle_config,
     "configs": handle_configs,
     "context": handle_context,
+    "disk": handle_disk,
     "doctor": handle_doctor,
     "disable": handle_disable,
     "enable": handle_enable,
@@ -107,6 +117,7 @@ _COMMAND_HANDLERS = {
     "next": handle_next,
     "notify": handle_notify,
     "repair": handle_repair,
+    "reset": handle_reset,
     "rename": handle_rename,
     "resume": handle_resume,
     "can-resume": handle_can_resume,
@@ -165,12 +176,14 @@ def _print_help(use_color=False):
         f"  {_style('cdx status --small|-s [--refresh|--cached] [--timeout SECONDS]', '36', use_color)}",
         f"  {_style('cdx status <name> [--json] [--refresh|--cached] [--timeout SECONDS]', '36', use_color)}",
         f"  {_style('cdx next [--json] [--refresh]', '36', use_color)}",
+        f"  {_style('cdx reset <name> [--yes] [--json]', '36', use_color)}",
         f"  {_style('cdx select --provider PROVIDER [--min-reasoning-effort minimal|low|medium|high|xhigh] [--min-power minimal|low|medium|high|xhigh] [--require-ready] [--refresh] --json', '36', use_color)}",
         f"  {_style('cdx run [session] --cwd PATH (--prompt-file PATH|--prompt TEXT) [--provider PROVIDER] [--model MODEL] [--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] --json', '36', use_color)}",
         f"  {_style('cdx runs [--limit N] --json', '36', use_color)}",
         f"  {_style('cdx run-status <run_id> --json', '36', use_color)}",
         f"  {_style('cdx run-report <run_id> --json', '36', use_color)}",
         f"  {_style('cdx context show|path|init|edit|clear|set [text...] [--json]', '36', use_color)}",
+        f"  {_style('cdx disk [profiles] [--candidates] [--json]', '36', use_color)}",
         f"  {_style('cdx config <name> [--json]', '36', use_color)}",
         f"  {_style('cdx configs [--json]', '36', use_color)}",
         f"  {_style('cdx power|perm|fast|model <name|all|provider:PROVIDER|a,b> <value|default> [--json]', '36', use_color)}",
@@ -191,7 +204,8 @@ def _print_help(use_color=False):
         f"  {_style('cdx disable <name> [--json]', '36', use_color)}",
         f"  {_style('cdx enable <name> [--json]', '36', use_color)}",
         f"  {_style('cdx rmv <name> [--force] [--json]', '36', use_color)}",
-        f"  {_style('cdx clean [name] [--json]', '36', use_color)}",
+        f"  {_style('cdx clean [name] [--yes] [--json]', '36', use_color)}",
+        f"  {_style('cdx clean profiles (--tmp|--old-logs DAYS) [--yes] [--json]', '36', use_color)}",
         f"  {_style('cdx export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR|--passphrase-stdin] [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx import <file> [--sessions a,b] [--passphrase-env VAR|--passphrase-stdin] [--force|--merge] [--json]', '36', use_color)}",
         f"  {_style('cdx doctor [--json]', '36', use_color)}",
@@ -264,9 +278,154 @@ def _get_update_notices(service, env, options):
     )
     if logics_notice:
         notices.append(logics_notice)
+    disk_notice = _get_disk_cleanup_notice(service, options)
+    if disk_notice:
+        notices.append(disk_notice)
     return notices
 
 
+_DISK_CHECK_INTERVAL_SECONDS = 24 * 60 * 60
+_DISK_HOME_THRESHOLD_BYTES = 10 * 1024 * 1024 * 1024
+_DISK_RECLAIMABLE_THRESHOLD_BYTES = 1 * 1024 * 1024 * 1024
+_DISK_CATEGORY_THRESHOLD_BYTES = 500 * 1024 * 1024
+_DISK_PROFILE_THRESHOLD_BYTES = 2 * 1024 * 1024 * 1024
+
+
+def _now_utc(options):
+    now_fn = options.get("now")
+    value = now_fn() if callable(now_fn) else None
+    if isinstance(value, datetime):
+        return value.astimezone(timezone.utc)
+    return datetime.now(timezone.utc)
+
+
+def _read_json_file(path):
+    try:
+        with open(path, encoding="utf-8") as handle:
+            return json.load(handle)
+    except (OSError, ValueError):
+        return {}
+
+
+def _write_json_file(path, payload):
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    tmp_path = f"{path}.tmp"
+    with open(tmp_path, "w", encoding="utf-8") as handle:
+        json.dump(payload, handle, indent=2, sort_keys=True)
+        handle.write("\n")
+    os.replace(tmp_path, path)
+
+
+def _parse_iso_datetime(value):
+    if not value:
+        return None
+    try:
+        return datetime.fromisoformat(str(value).replace("Z", "+00:00")).astimezone(timezone.utc)
+    except ValueError:
+        return None
+
+
+def _get_disk_cleanup_notice(service, options):
+    checker = options.get("checkDiskCleanup")
+    if callable(checker):
+        return checker(service, options)
+
+    base_dir = service["base_dir"]
+    state_path = os.path.join(base_dir, "state", "disk-cleanup-check.json")
+    now = _now_utc(options)
+    state = _read_json_file(state_path)
+    last_checked = _parse_iso_datetime(state.get("last_checked_at"))
+    if last_checked and (now - last_checked).total_seconds() < _DISK_CHECK_INTERVAL_SECONDS:
+        return None
+
+    runner = options.get("diskUsageRunner")
+    try:
+        home_bytes = _directory_size_bytes(base_dir, runner=runner)
+        profiles_dir = os.path.join(base_dir, "profiles")
+        profile_rows = _directory_child_sizes(profiles_dir, runner=runner)
+        profile_total = sum(row["bytes"] for row in profile_rows)
+        candidates = _collect_profile_cleanup_candidates(base_dir, runner=runner, now=now.timestamp())
+    except Exception:
+        return None
+
+    reclaimable_bytes = sum(item["bytes"] for item in candidates)
+    tmp_bytes = sum(item["bytes"] for item in candidates if item["kind"].startswith("tmp-"))
+    old_log_bytes = sum(item["bytes"] for item in candidates if item["kind"].startswith("old-logs-"))
+    large_profiles = [
+        {
+            "name": row["name"],
+            "bytes": row["bytes"],
+            "size": _format_disk_bytes(row["bytes"]),
+            "share_pct": round((row["bytes"] / profile_total) * 100, 1) if profile_total else 0,
+        }
+        for row in profile_rows
+        if row["bytes"] >= _DISK_PROFILE_THRESHOLD_BYTES
+        or (
+            profile_total >= _DISK_RECLAIMABLE_THRESHOLD_BYTES
+            and row["bytes"] / profile_total >= 0.25
+        )
+    ]
+    triggered = (
+        home_bytes >= _DISK_HOME_THRESHOLD_BYTES
+        or reclaimable_bytes >= _DISK_RECLAIMABLE_THRESHOLD_BYTES
+        or tmp_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES
+        or old_log_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES
+        or bool(large_profiles)
+    )
+    state_payload = {
+        "last_checked_at": now.isoformat(),
+        "home_bytes": home_bytes,
+        "reclaimable_bytes": reclaimable_bytes,
+        "tmp_bytes": tmp_bytes,
+        "old_log_bytes": old_log_bytes,
+        "large_profiles": large_profiles,
+    }
+    try:
+        _write_json_file(state_path, state_payload)
+    except OSError:
+        pass
+    if not triggered:
+        return None
+
+    if reclaimable_bytes > 0:
+        message = (
+            f"Disk cleanup available: {_format_disk_bytes(reclaimable_bytes)} reclaimable "
+            f"in CDX profiles. Inspect: cdx disk profiles --candidates"
+        )
+    else:
+        message = (
+            f"CDX_HOME uses {_format_disk_bytes(home_bytes)}. "
+            "Inspect: cdx disk profiles --candidates"
+        )
+    if tmp_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES:
+        message = (
+            f"{message}. Safe temp cleanup: {_format_disk_bytes(tmp_bytes)} "
+            "with cdx clean profiles --tmp"
+        )
+    if old_log_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES:
+        message = (
+            f"{message}. Old logs: {_format_disk_bytes(old_log_bytes)} "
+            "with cdx clean profiles --old-logs 30d"
+        )
+    return {
+        "tool": "cdx-disk",
+        "code": "disk_cleanup_available",
+        "message": message,
+        "reclaimable_bytes": reclaimable_bytes,
+        "reclaimable_size": _format_disk_bytes(reclaimable_bytes),
+        "home_bytes": home_bytes,
+        "home_size": _format_disk_bytes(home_bytes),
+        "tmp_bytes": tmp_bytes,
+        "tmp_size": _format_disk_bytes(tmp_bytes),
+        "old_log_bytes": old_log_bytes,
+        "old_log_size": _format_disk_bytes(old_log_bytes),
+        "large_profiles": large_profiles,
+        "inspect_command": "cdx disk profiles --candidates",
+        "cleanup_tmp_command": "cdx clean profiles --tmp" if tmp_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES else None,
+        "cleanup_old_logs_command": "cdx clean profiles --old-logs 30d" if old_log_bytes >= _DISK_CATEGORY_THRESHOLD_BYTES else None,
+    }
+
+
 def _update_warning_payload(notices):
     if isinstance(notices, dict):
         notices = [notices]
@@ -274,6 +433,13 @@ def _update_warning_payload(notices):
         return []
     warnings = []
     for notice in notices:
+        if notice.get("code") == "disk_cleanup_available":
+            warnings.append({
+                "code": "disk_cleanup_available",
+                "message": notice["message"],
+                **{key: value for key, value in notice.items() if key not in ("code", "message")},
+            })
+            continue
         tool = notice.get("tool") or "cdx-manager"
         current = notice.get("current_version") or VERSION
         command = notice.get("update_command") or ("cdx update" if tool == "cdx-manager" else None)

package/src/cli_args.py

@@ -13,6 +13,7 @@ from .provider_runtime import _normalize_reasoning_effort
 
 STATUS_USAGE = "Usage: cdx status [--json] [--refresh|--cached] [--timeout SECONDS] | cdx status --small|-s [--refresh|--cached] [--timeout SECONDS] | cdx status <name> [--json] [--refresh|--cached] [--timeout SECONDS]"
 DOCTOR_USAGE = "Usage: cdx doctor [--json]"
+DISK_USAGE = "Usage: cdx disk [profiles] [--candidates] [--json]"
 REPAIR_USAGE = "Usage: cdx repair [--dry-run] [--force] [--json]"
 UPDATE_USAGE = "Usage: cdx update [--check] [--yes] [--json] [--version TAG]"
 EXPORT_USAGE = "Usage: cdx export <file> [--include-auth] [--force] [--json] [--sessions name1,name2] [--passphrase-env VAR|--passphrase-stdin]"