cdx-manager 0.5.7 → 0.6.1

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.7-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.1-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,10 +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.
@@ -63,6 +67,7 @@ One command to launch any session. Zero auth juggling.
   - Codex live source: `codex app-server` JSON-RPC `account/rateLimits/read`, normalized into 5-hour, weekly, reset, credit, and plan fields.
   - Fallback: `status-source` scans provider JSONL history files and terminal log transcripts, strips ANSI/OSC sequences, and extracts `usage%`, `5h remaining%`, and `week remaining%` via pattern matching.
 - Claude status refreshes are cached briefly by default; pass `--refresh` to force a live rate-limit probe.
+- On Linux, transcript capture uses the `util-linux` `script -c` command form.
 - If `script` is unavailable, Codex launch falls back to running without transcript capture.
 - On Windows, transcript capture is optional. If no compatible `script` wrapper is installed, Codex still launches normally without transcript capture.
 - Auth probe: synchronous subprocess call to `codex login status` or `claude auth status` before any interactive launch.
@@ -127,7 +132,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.7 sh install.sh
+CDX_VERSION=v0.6.1 sh install.sh
 ```
 
 From source:
@@ -230,6 +235,18 @@ 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
@@ -251,6 +268,22 @@ 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
@@ -271,6 +304,8 @@ cdx unset work --all
 | `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 |
@@ -281,6 +316,7 @@ cdx unset work --all
 | `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 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 |
@@ -313,9 +349,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:
@@ -452,6 +491,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_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/changelogs/CHANGELOGS_0_6_1.md

@@ -0,0 +1,30 @@
+# Changelog (`0.6.0 -> 0.6.1`)
+
+Release date: 2026-05-28
+
+## Handoff Reliability
+
+- Fixed `cdx handoff <source> <target>` when a source session has no `cdx-session*.log` launch transcript.
+- Added fallback discovery for native provider histories, including Claude project JSONL files under the isolated session home.
+- Converted JSONL message records into readable role-prefixed handoff context instead of requiring raw terminal logs.
+
+## Linux Transcript Capture
+
+- Fixed default transcript capture on Linux and Arch Linux by using the `util-linux` `script -q -F -c "<command>" <transcript>` form.
+- Kept the existing BSD/macOS `script` invocation unchanged.
+- Preserved custom `CDX_SCRIPT_ARGS` behavior for users who explicitly configure their wrapper.
+
+## Release Metadata and Documentation
+
+- Updated package metadata, CLI version output, README badge, and pinned installer example to `v0.6.1`.
+- Documented the Linux-specific transcript capture behavior in the README.
+
+## Validation and Regression Coverage
+
+- Added regression coverage for Claude-to-Claude handoff from native `.claude/projects/*.jsonl` history when no launch log exists.
+- Added runtime coverage for the Linux `script` invocation shape.
+
+## Validation and Regression Evidence
+
+- `npm run lint`
+- `npm test`

package/package.json

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

package/src/cli.py

@@ -18,6 +18,8 @@ from .cli_commands import (
     handle_export,
     handle_import,
     handle_handoff,
+    handle_history,
+    handle_last,
     handle_launch,
     handle_login,
     handle_logout,
@@ -52,7 +54,7 @@ from .status_view import (
 )
 from .update_check import check_for_update
 
-VERSION = "0.5.7"
+VERSION = "0.6.1"
 
 
 # ---------------------------------------------------------------------------
@@ -73,6 +75,8 @@ def _print_help(use_color=False):
         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)}",
@@ -89,6 +93,7 @@ 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 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)}",
@@ -156,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"
 
 
 # ---------------------------------------------------------------------------
@@ -227,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", "config", "set", "unset", "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,
     }
@@ -268,6 +272,11 @@ 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)
 
@@ -283,6 +292,12 @@ def main(argv, options=None):
     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)