cdx-manager 0.5.2 → 0.5.3

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.2-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.5.3-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.**
 
@@ -126,7 +126,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.2 sh install.sh
+CDX_VERSION=v0.5.3 sh install.sh
 ```
 
 From source:
@@ -250,7 +250,7 @@ cdx status
 | `cdx enable <name> [--json]` | Re-enable a disabled session |
 | `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 |
+| `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 |
 | `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 export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR] [--force] [--json]` | Export sessions to a portable bundle; `--include-auth` encrypts auth data with a passphrase |

package/changelogs/CHANGELOGS_0_5_3.md

@@ -0,0 +1,42 @@
+# Changelog (`0.5.2 -> 0.5.3`)
+
+Release date: 2026-05-23
+
+## Major Highlights
+
+- Added Claude-compatible handoff launch prompting so Claude targets are told exactly which `shared-context.md` file to read.
+- Added Claude launch transcript capture, enabling transcript-based handoff from Claude source sessions.
+- Enabled cross-provider transcript handoff between Codex and Claude sessions.
+- Prepared the package metadata for the 0.5.3 release across npm, PyPI, CLI version output, and README install examples.
+
+## Claude Handoff
+
+- Passes the handoff prompt to Claude as the initial prompt argument during launch.
+- Installs shared context into the target Claude session profile and references the concrete `shared-context.md` path in the prompt.
+- Captures Claude launch transcripts under the session's `claude-home/log/` directory using the same transcript wrapper path as Codex.
+- Preserves Claude `HOME` isolation while running through the transcript wrapper.
+
+## Cross-Provider Handoff
+
+- Allows `cdx handoff <source> <target>` when the source and target providers differ.
+- Keeps generated handoff context provider-neutral while still recording source and target provider metadata.
+- Preserves target account authentication and does not copy source credentials.
+
+## Documentation
+
+- Updated the command table to document Codex and Claude handoff targets, including cross-provider handoff.
+- Updated the README badge and pinned installer example to `v0.5.3`.
+
+## Validation and Regression Coverage
+
+- Added CLI coverage for Claude-to-Claude transcript handoff.
+- Added CLI coverage for Codex-to-Claude handoff.
+- Added CLI coverage proving non-JSON Claude handoff launches Claude with the resume prompt.
+- Updated existing Claude launch coverage to verify transcript-wrapped launches.
+
+## Validation and Regression Evidence
+
+- `python3 -m pytest test/test_cli_py.py test/test_runtime_py.py`
+- `python3 -m pytest`
+- `npm run lint`
+- `npm test`

package/package.json

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

package/src/cli.py

@@ -49,7 +49,7 @@ from .status_view import (
 )
 from .update_check import check_for_update
 
-VERSION = "0.5.2"
+VERSION = "0.5.3"
 
 
 # ---------------------------------------------------------------------------

package/src/cli_commands.py

@@ -111,9 +111,16 @@ def _build_handoff_context(source, target, transcript_path, transcript, truncate
     ])
 
 
-def _handoff_launch_prompt():
+def _handoff_launch_prompt(session, install=None):
+    if session.get("provider") == "codex":
+        context_ref = "$CODEX_HOME/shared-context.md"
+    else:
+        context_ref = (install or {}).get("target_path") or os.path.join(
+            session.get("authHome") or session.get("sessionRoot") or "~",
+            "shared-context.md",
+        )
     return (
-        "Read $CODEX_HOME/shared-context.md first, then resume the previous session "
+        f"Read {context_ref} first, then resume the previous session "
         "from the latest actionable state. Do not ask me to paste the context again."
     )
 
@@ -1017,18 +1024,19 @@ def handle_handoff(rest, ctx):
         if not session:
             raise CdxError(f"Unknown session: {name}")
         install = install_context_for_session(ctx["service"]["base_dir"], session, ctx.get("cwd"))
+        launch_prompt = _handoff_launch_prompt(session, install)
         if json_flag:
             _write_json(ctx, _json_success(
                 "handoff",
                 f"Installed shared context for {name}",
                 context=install,
-                launch_prompt=_handoff_launch_prompt(),
+                launch_prompt=launch_prompt,
                 session=session,
             ))
             return 0
         text = f"Shared context installed for {name}: {install['target_path']}"
         ctx["out"](f"{_info(text, ctx['use_color'])}\n")
-        return handle_launch(name, ctx, initial_prompt=_handoff_launch_prompt())
+        return handle_launch(name, ctx, initial_prompt=launch_prompt)
 
     source_name, target_name = args
     if source_name == target_name:
@@ -1039,8 +1047,6 @@ def handle_handoff(rest, ctx):
     target = ctx["service"]["get_session"](target_name)
     if not target:
         raise CdxError(f"Unknown session: {target_name}")
-    if source["provider"] != target["provider"]:
-        raise CdxError("Source and target sessions must use the same provider for handoff.")
     transcript_path = _latest_launch_transcript_path(source)
     if not transcript_path:
         raise CdxError(f"No launch transcript found for session: {source_name}")
@@ -1048,6 +1054,7 @@ def handle_handoff(rest, ctx):
     context = _build_handoff_context(source, target, transcript_path, transcript, truncated=truncated)
     write_result = write_context(ctx["service"]["base_dir"], context, ctx.get("cwd"))
     install = install_context_for_session(ctx["service"]["base_dir"], target, ctx.get("cwd"))
+    launch_prompt = _handoff_launch_prompt(target, install)
     if json_flag:
         _write_json(ctx, _json_success(
             "handoff",
@@ -1057,9 +1064,9 @@ def handle_handoff(rest, ctx):
             target_session=target,
             source_transcript=transcript_path,
             shared_context=write_result,
-            launch_prompt=_handoff_launch_prompt(),
+            launch_prompt=launch_prompt,
         ))
         return 0
     text = f"Handoff prepared from {source_name} to {target_name}: {install['target_path']}"
     ctx["out"](f"{_info(text, ctx['use_color'])}\n")
-    return handle_launch(target_name, ctx, initial_prompt=_handoff_launch_prompt())
+    return handle_launch(target_name, ctx, initial_prompt=launch_prompt)

package/src/provider_runtime.py

@@ -103,15 +103,18 @@ def _build_launch_spec(session, cwd=None, env_override=None, initial_prompt=None
     env_override = env_override or {}
     env = {**os.environ, **env_override}
     if session["provider"] == "claude":
-        return {
+        args = ["--name", session["name"]]
+        if initial_prompt:
+            args.append(initial_prompt)
+        return _wrap_launch_with_transcript(session, {
             "command": "claude",
-            "args": ["--name", session["name"]],
+            "args": args,
             "options": {
                 "cwd": cwd,
                 "env": {**env, **_home_env_overrides(_get_auth_home(session))},
             },
             "label": "claude",
-        }
+        }, env=env)
     args = ["--no-alt-screen", "--cd", cwd]
     if initial_prompt:
         args.append(initial_prompt)