cdx-manager 0.5.6 → 0.6.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.5.6-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.6.0-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
 
 **Run multiple Codex and Claude sessions from one terminal. Switch between accounts instantly.**
 
@@ -34,9 +34,14 @@ One command to launch any session. Zero auth juggling.
 
 - **Multiple accounts, one tool.** Register as many Codex or Claude sessions as you need. Each one gets its own isolated auth environment — no cross-contamination between accounts.
 - **Instant launch.** `cdx work` opens your "work" session. `cdx personal` opens another. No config files to edit mid-flow.
+- **Quick relaunch.** `cdx last` reopens the most recently launched assistant profile.
 - **Auth guardrails.** `cdx` checks authentication before launching. If a session is not logged in, it tells you exactly what to run — no silent failures.
 - **Usage at a glance.** `cdx status` shows token usage, 5-hour window quota, weekly quota, last-updated timestamps, priority guidance, and the last launched session in one aligned table.
+- **Next-ready notification.** `cdx ready` schedules a native system notification for the next assistant that comes back from cooldown, then returns immediately.
 - **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.
+- **Update prompts.** Periodic update checks surface `cdx update` directly in the `cdx`, `cdx status`, and launch output when a newer release is available.
 - **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.
 - **Session transcript capture.** Every launch is recorded to a local log file via `script`, giving you a full terminal transcript for each session.
@@ -126,7 +131,7 @@ For a specific version:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/AlexAgo83/cdx-manager/main/install.sh -o install.sh
-CDX_VERSION=v0.5.6 sh install.sh
+CDX_VERSION=v0.6.0 sh install.sh
 ```
 
 From source:
@@ -229,8 +234,55 @@ cdx work
 
 # Check usage across all sessions
 cdx status
+
+# Notify when the next cooling-down assistant is ready
+cdx ready
+```
+
+### Next-Ready Notifications
+
+Use `cdx ready` when every useful assistant is cooling down and you want your terminal back. It is shorthand for `cdx notify --schedule --next-ready`: cdx picks the next known reset, registers a native OS notification, and exits immediately.
+
+```bash
+cdx ready
+cdx ready --refresh
+```
+
+### Persistent Launch Settings
+
+By default, `cdx` launches provider CLIs without forcing model effort, permission mode, or fast behavior. Set only the values you want to pin:
+
+```bash
+cdx set work --power medium --permission full --fast off
+cdx set personal --power low --permission review
+cdx config work
 ```
 
+Those values are stored on the session and reapplied every time you run `cdx work`. Remove overrides to return to provider defaults:
+
+```bash
+cdx unset work --power
+cdx unset work --all
+```
+
+`--power` maps to Codex `model_reasoning_effort` and Claude `--effort`. `--permission` maps to provider-native permission flags. `--fast on` uses low effort when no explicit power is set.
+
+### Launch History
+
+Every interactive `cdx <name>` launch is recorded under `CDX_HOME`, including success/failure, duration, cwd, launch settings, and transcript path.
+
+```bash
+cdx history
+cdx history work
+cdx history work --limit 5
+cdx history work --json
+cdx history --summary
+cdx history --summary --since 7d
+cdx history --summary --from 2026-05-01 --to 2026-05-28
+```
+
+`cdx history --summary` aggregates total time per assistant. Add `--since`, `--from`, or `--to` to focus on a period.
+
 ---
 
 ## All Commands
@@ -248,6 +300,11 @@ cdx status
 | `cdx logout <name> [--json]` | Log out of a session |
 | `cdx disable <name> [--json]` | Disable a session without deleting it; disabled sessions stay visible and cannot launch |
 | `cdx enable <name> [--json]` | Re-enable a disabled session |
+| `cdx config <name> [--json]` | Show persistent launch settings for a session |
+| `cdx set <name> [--power low\|medium\|high\|xhigh\|max] [--permission review\|default\|auto\|full] [--fast on\|off] [--json]` | Persist launch settings for a session |
+| `cdx unset <name> (--power\|--permission\|--fast\|--all) [--json]` | Remove persisted launch settings and fall back to provider defaults |
+| `cdx history [name] [--limit N] [--summary] [--since 7d\|today\|DATE] [--from DATE] [--to DATE] [--json]` | Show recent launch history or aggregate total launch time per assistant, optionally filtered by period |
+| `cdx last [--json]` | Launch the most recent existing session from launch history |
 | `cdx context show\|path\|init\|edit\|clear\|set [text...] [--json]` | Manage the shared Markdown context for the current workspace |
 | `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 Codex and Claude targets, including cross-provider handoff |
@@ -258,8 +315,9 @@ cdx status
 | `cdx doctor [--json]` | Inspect CLI dependencies, CDX_HOME permissions, missing state, orphan profiles, and pending quarantines |
 | `cdx repair [--dry-run] [--force] [--json]` | Plan or apply safe repairs for missing state files, quarantines, and orphan profiles |
 | `cdx update [--check] [--yes] [--json] [--version TAG]` | Update cdx-manager using the installer that matches how it was installed |
-| `cdx notify <name> --at-reset [--poll seconds] [--once] [--refresh] [--json]` | Wait for a session reset time and send a desktop notification when due |
-| `cdx notify --next-ready [--poll seconds] [--once] [--refresh] [--json]` | Wait until the recommended session is usable or needs a refresh after reset |
+| `cdx ready [--refresh] [--json]` | Schedule an OS notification for the next cooling-down assistant that becomes ready, then return immediately |
+| `cdx notify <name> --at-reset [--poll seconds] [--once] [--schedule] [--refresh] [--json]` | Wait for a session reset time or schedule an OS wake-up notification when due |
+| `cdx notify --next-ready [--poll seconds] [--once] [--schedule] [--refresh] [--json]` | Wait until the recommended session is usable, or schedule the next known reset notification |
 | `cdx status [--json] [--refresh]` | Show token usage table for all sessions; JSON returns a versioned payload with structured warnings |
 | `cdx status --small [--refresh]` / `cdx status -s [--refresh]` | Show compact token usage table without provider, blocking quota, credits, and updated columns |
 | `cdx status <name> [--json] [--refresh]` | Show detailed usage breakdown for one session |
@@ -290,9 +348,12 @@ Commands with machine-readable output:
 - `cdx enable ... --json`
 - `cdx context ... --json`
 - `cdx handoff ... --json`
+- `cdx history ... --json`
+- `cdx last --json`
 - `cdx doctor --json`
 - `cdx repair --json`
 - `cdx update --json`
+- `cdx ready --json`
 - `cdx notify ... --json`
 
 Success payloads follow a shared envelope:
@@ -429,6 +490,7 @@ All session data lives under `CDX_HOME` (default: `~/.cdx/`):
   sessions.json             # Session registry (versioned, all sessions)
   state/
     <encoded-name>.json     # Per-session rehydration state
+    launch_history.jsonl    # Append-only launch history
   profiles/
     <encoded-name>/         # Codex session: CODEX_HOME points here
       log/

package/changelogs/CHANGELOGS_0_5_7.md

@@ -0,0 +1,45 @@
+# Changelog (`0.5.6 -> 0.5.7`)
+
+Release date: 2026-05-27
+
+## Major Highlights
+
+- Added persistent per-session launch settings for Codex and Claude assistants.
+- Let users pin power, permission, and fast-mode preferences once and have `cdx` reapply them on every launch.
+- Preserved native provider defaults when no launch settings are configured.
+
+## Launch Settings
+
+- Added `cdx set <name>` with `--power`, `--permission`, and `--fast` options.
+- Added `cdx config <name>` to inspect the launch settings stored on a session.
+- Added `cdx unset <name>` to clear individual launch settings or all overrides with `--all`.
+- Stored launch settings directly on each CDX session record.
+- Copied launch settings when copying a session.
+- Exported and imported launch settings with session bundles.
+
+## Provider Runtime
+
+- Mapped Codex power settings to `model_reasoning_effort`.
+- Mapped Claude power settings to `--effort`.
+- Mapped Codex permission presets to sandbox and approval flags.
+- Mapped Claude permission presets to `--permission-mode`.
+- Treated `--fast on` as low effort when no explicit power setting is configured.
+
+## CLI Output and Documentation
+
+- Added launch settings to `cdx --help`.
+- Added a compact launch-settings column to `cdx` session listings when any session has overrides.
+- Documented the persistent launch-settings workflow in the README.
+- Updated package metadata, CLI version output, README badge, and pinned installer example to `v0.5.7`.
+
+## Validation and Regression Coverage
+
+- Added regression coverage for persistent Codex launch settings and `unset --all`.
+- Added regression coverage for persistent Claude launch settings and `cdx config`.
+- Added runtime coverage for `fast on` resolving to low effort when no power is configured.
+
+## Validation and Regression Evidence
+
+- `python -m py_compile bin/cdx src/*.py test/test_*_py.py`
+- `python -m unittest discover -s test -p 'test_*_py.py'`
+- `npm pack --dry-run`

package/changelogs/CHANGELOGS_0_6_0.md

@@ -0,0 +1,47 @@
+# Changelog (`0.5.7 -> 0.6.0`)
+
+Release date: 2026-05-28
+
+## Major Highlights
+
+- Added launch history workflows for reviewing, summarizing, and relaunching assistant sessions.
+- Improved `cdx status` guidance with reset-week countdowns, active-session marking, cleaner blocking quota labels, and periodic update notices.
+- Added shortcut commands that reduce routine assistant switching and waiting friction.
+
+## Launch History and Relaunch
+
+- Added `cdx history` to inspect recent assistant launches with provider, result, duration, working directory, launch settings, and transcript path.
+- Added `cdx history --summary` to aggregate assistant time by session.
+- Added period filters for history summaries with `--since`, `--from`, and `--to`.
+- Added `cdx last` to relaunch the most recent existing session from launch history.
+- Skips removed sessions when resolving the last launch target.
+
+## Status and Availability
+
+- Added reset-week countdowns to status output.
+- Hid healthy blocking quota labels so status tables stay focused on actionable quota limits.
+- Marked the active launched session in status and list output.
+- Added `cdx ready` as a shortcut for scheduling the next assistant reset notification.
+- Added update notices to `cdx status`, matching the existing periodic update check behavior.
+- Changed visual update notices to show `Run: cdx update` instead of a release URL.
+
+## CLI Ergonomics
+
+- Curated the main screen next-actions list around the commands users are most likely to run next.
+- Kept release URLs in JSON warning payloads for integrations while making text output directly actionable.
+- Added `cdx last [--json]` to help output and README command documentation.
+
+## Release Metadata and Documentation
+
+- Updated package metadata, CLI version output, README badge, and pinned installer example to `v0.6.0`.
+- Documented `cdx last` and the action-oriented update notices in the README.
+
+## Validation and Regression Coverage
+
+- Added regression coverage for launch history, assistant-time summaries, period filters, active session indicators, `cdx ready`, `cdx last`, and update notices in `cdx status`.
+- Added coverage to ensure visual update notices show `Run: cdx update` without leaking the release URL.
+
+## Validation and Regression Evidence
+
+- `npm run lint`
+- `npm test`

package/package.json

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

package/src/cli.py

@@ -9,6 +9,7 @@ from .cli_commands import (
     STATUS_USAGE,
     handle_add,
     handle_clean,
+    handle_config,
     handle_context,
     handle_copy,
     handle_doctor,
@@ -17,6 +18,8 @@ from .cli_commands import (
     handle_export,
     handle_import,
     handle_handoff,
+    handle_history,
+    handle_last,
     handle_launch,
     handle_login,
     handle_logout,
@@ -25,6 +28,8 @@ from .cli_commands import (
     handle_repair,
     handle_rename,
     handle_status,
+    handle_set,
+    handle_unset,
     handle_update,
 )
 from .cli_render import (
@@ -49,7 +54,7 @@ from .status_view import (
 )
 from .update_check import check_for_update
 
-VERSION = "0.5.6"
+VERSION = "0.6.0"
 
 
 # ---------------------------------------------------------------------------
@@ -67,6 +72,11 @@ def _print_help(use_color=False):
         f"  {_style('cdx status --small|-s [--refresh]', '36', use_color)}",
         f"  {_style('cdx status <name> [--json] [--refresh]', '36', use_color)}",
         f"  {_style('cdx context show|path|init|edit|clear|set [text...] [--json]', '36', use_color)}",
+        f"  {_style('cdx config <name> [--json]', '36', use_color)}",
+        f"  {_style('cdx set <name> [--power low|medium|high|xhigh|max] [--permission review|default|auto|full] [--fast on|off] [--json]', '36', use_color)}",
+        f"  {_style('cdx unset <name> (--power|--permission|--fast|--all) [--json]', '36', use_color)}",
+        f"  {_style('cdx history [name] [--limit N] [--summary] [--since 7d|today|DATE] [--from DATE] [--to DATE] [--json]', '36', use_color)}",
+        f"  {_style('cdx last [--json]', '36', use_color)}",
         f"  {_style('cdx handoff <name> [--json]', '36', use_color)}",
         f"  {_style('cdx handoff <source> <target> [--json]', '36', use_color)}",
         f"  {_style('cdx add [provider] <name> [--json]', '36', use_color)}",
@@ -83,8 +93,9 @@ def _print_help(use_color=False):
         f"  {_style('cdx doctor [--json]', '36', use_color)}",
         f"  {_style('cdx repair [--dry-run] [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx update [--check] [--yes] [--json] [--version TAG]', '36', use_color)}",
-        f"  {_style('cdx notify <name> --at-reset [--refresh] [--json]', '36', use_color)}",
-        f"  {_style('cdx notify --next-ready [--refresh] [--json]', '36', use_color)}",
+        f"  {_style('cdx ready [--refresh] [--json]', '36', use_color)}",
+        f"  {_style('cdx notify <name> --at-reset [--schedule] [--refresh] [--json]', '36', use_color)}",
+        f"  {_style('cdx notify --next-ready [--schedule] [--refresh] [--json]', '36', use_color)}",
         f"  {_style('cdx <name> [--json]', '36', use_color)}",
         f"  {_style('cdx --help', '36', use_color)}",
         f"  {_style('cdx --version', '36', use_color)}",
@@ -150,8 +161,7 @@ def _update_warning_payload(notice):
 def _update_warning_text(notice):
     if not notice:
         return None
-    suffix = f" {notice['url']}" if notice.get("url") else ""
-    return f"Update available: cdx-manager {notice['latest_version']} (current {VERSION}).{suffix}"
+    return f"Update available: cdx-manager {notice['latest_version']} (current {VERSION}). Run: cdx update"
 
 
 # ---------------------------------------------------------------------------
@@ -221,7 +231,7 @@ def main(argv, options=None):
         "version": VERSION,
         "cwd": options.get("cwd") or os.getcwd(),
         "update_notice": _get_update_notice(service, env, options) if command not in (
-            "add", "cp", "ren", "rename", "mv", "rmv", "clean", "doctor", "repair", "update", "notify", "status", "context", "handoff", "login", "logout", "disable", "enable", "export", "import", "help", "version"
+            "add", "cp", "ren", "rename", "mv", "rmv", "clean", "doctor", "repair", "update", "ready", "notify", "context", "config", "set", "unset", "history", "handoff", "login", "logout", "disable", "enable", "export", "import", "help", "version"
         ) else None,
         "use_color": use_color,
     }
@@ -262,12 +272,32 @@ def main(argv, options=None):
     if command == "update":
         return handle_update(rest, ctx)
 
+    if command == "ready":
+        if any(arg not in ("--refresh", "--json") for arg in rest):
+            raise CdxError("Usage: cdx ready [--refresh] [--json]")
+        return handle_notify(["--next-ready", "--schedule", *rest], ctx)
+
     if command == "notify":
         return handle_notify(rest, ctx)
 
     if command == "context":
         return handle_context(rest, ctx)
 
+    if command == "config":
+        return handle_config(rest, ctx)
+
+    if command == "set":
+        return handle_set(rest, ctx)
+
+    if command == "unset":
+        return handle_unset(rest, ctx)
+
+    if command == "history":
+        return handle_history(rest, ctx)
+
+    if command == "last":
+        return handle_last(rest, ctx)
+
     if command == "handoff":
         return handle_handoff(rest, ctx)