cdx-manager 0.2.1 → 0.3.2

package/README.md

@@ -6,7 +6,7 @@ If you use AI coding tools at scale ; multiple accounts, multiple providers : yo
 
 One command to launch any session. Zero auth juggling.
 
-[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.2.1-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.3.2-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
 
 ---
 
@@ -69,6 +69,38 @@ One command to launch any session. Zero auth juggling.
 
 ### Install
 
+From npm:
+
+```bash
+npm install -g cdx-manager
+```
+
+With pipx:
+
+```bash
+pipx install cdx-manager
+```
+
+With uv:
+
+```bash
+uv tool install cdx-manager
+```
+
+With the standalone GitHub installer:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/AlexAgo83/cdx-manager/main/install.sh | sh
+```
+
+For a specific version:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/AlexAgo83/cdx-manager/main/install.sh | CDX_VERSION=v0.3.2 sh
+```
+
+From source:
+
 ```bash
 git clone <repo>
 cd cdx-manager
@@ -83,18 +115,12 @@ To uninstall:
 make uninstall
 ```
 
-Alternatively, for a non-symlinked global install:
+Alternatively, for a non-symlinked global source install:
 
 ```bash
 npm install -g .
 ```
 
-Once published to npm:
-
-```bash
-npm install -g cdx-manager
-```
-
 ### Environment
 
 By default, `cdx` stores all data under `~/.cdx/`. Override with:

package/changelogs/CHANGELOGS_0_3_0.md

@@ -0,0 +1,32 @@
+# CHANGELOGS_0_3_0
+
+Release date: 2026-04-16
+
+## CDX Manager 0.3.0
+
+CDX Manager 0.3.0 adds Python-native and standalone installation paths in addition to npm.
+
+### Packaging
+
+- Added `pyproject.toml` so the CLI can be installed with `pipx`, `pip`, or `uv tool`.
+- Added the Python console entrypoint `cdx = "src.cli:cli_entry"`.
+- Added `install.sh` for GitHub Release based installs into `~/.local/share/cdx-manager` with a symlink in `~/.local/bin`.
+- Included `install.sh` and `pyproject.toml` in the npm package file list.
+- Documented npm, pipx, uv, curl installer, and source installation paths.
+- Added GitHub Actions automation for PyPI publication when a GitHub Release is published.
+
+### Validation
+
+```bash
+npm run lint
+npm test
+python3 -m venv /tmp/cdx-pyinstall
+/tmp/cdx-pyinstall/bin/pip install --no-build-isolation .
+/tmp/cdx-pyinstall/bin/cdx --version
+npm --cache /tmp/cdx-npm-cache publish --dry-run
+```
+
+### Notes
+
+- PyPI publication is now technically possible, but still requires PyPI credentials and an explicit publish step.
+- The standalone installer defaults to the latest GitHub Release and supports `CDX_VERSION=vX.Y.Z` for pinned installs.

package/changelogs/CHANGELOGS_0_3_1.md

@@ -0,0 +1,27 @@
+# CHANGELOGS_0_3_1
+
+Release date: 2026-04-16
+
+## CDX Manager 0.3.1
+
+CDX Manager 0.3.1 is a release-channel synchronization update.
+
+### Packaging
+
+- Uses npm Trusted Publishing through GitHub Actions OIDC instead of long-lived npm tokens.
+- Keeps npm, PyPI, GitHub Releases, pipx, uv, and the standalone installer aligned on the same release version.
+- Retains the Python-native packaging and standalone install support introduced in 0.3.0.
+
+### Validation
+
+```bash
+npm run lint
+npm test
+npm --cache /tmp/cdx-npm-cache publish --dry-run
+python -m build
+python -m twine check dist/*
+```
+
+### Notes
+
+- This release exists because the npm Trusted Publishing workflow was added after the `v0.3.0` tag. A fresh release is required for GitHub Actions to run the updated workflow definition for npm publishing.

package/changelogs/CHANGELOGS_0_3_2.md

@@ -0,0 +1,21 @@
+# CHANGELOGS_0_3_2
+
+Release date: 2026-04-16
+
+## CDX Manager 0.3.2
+
+CDX Manager 0.3.2 updates the npm release workflow to use the npm CLI version required for Trusted Publishing.
+
+### Packaging
+
+- Runs the npm publish workflow on Node 24.
+- Installs npm 11 before publishing so GitHub Actions OIDC trusted publishing is supported.
+- Keeps npm, PyPI, GitHub Releases, pipx, uv, and the standalone installer aligned on the same release version.
+
+### Validation
+
+```bash
+npm run lint
+npm test
+npm --cache /tmp/cdx-npm-cache publish --dry-run
+```

package/install.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env sh
+set -eu
+
+REPO="AlexAgo83/cdx-manager"
+VERSION="${CDX_VERSION:-}"
+PREFIX="${PREFIX:-$HOME/.local}"
+BIN_DIR="${BIN_DIR:-$PREFIX/bin}"
+INSTALL_ROOT="${CDX_INSTALL_ROOT:-$PREFIX/share/cdx-manager}"
+
+need() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "cdx install: missing required command: $1" >&2
+    exit 1
+  fi
+}
+
+need curl
+need tar
+need python3
+
+if [ -z "$VERSION" ]; then
+  VERSION="$(
+    curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" |
+      python3 -c 'import json, sys; print(json.load(sys.stdin)["tag_name"])'
+  )"
+fi
+
+case "$VERSION" in
+  v*) TAG="$VERSION" ;;
+  *) TAG="v$VERSION" ;;
+esac
+
+TMP_DIR="$(mktemp -d)"
+cleanup() {
+  rm -rf "$TMP_DIR"
+}
+trap cleanup EXIT INT TERM
+
+ARCHIVE_URL="https://github.com/$REPO/archive/refs/tags/$TAG.tar.gz"
+curl -fsSL "$ARCHIVE_URL" -o "$TMP_DIR/cdx-manager.tar.gz"
+tar -xzf "$TMP_DIR/cdx-manager.tar.gz" -C "$TMP_DIR"
+
+SRC_DIR="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
+TARGET_DIR="$INSTALL_ROOT/${TAG#v}"
+
+mkdir -p "$INSTALL_ROOT" "$BIN_DIR"
+rm -rf "$TARGET_DIR"
+mkdir -p "$TARGET_DIR"
+
+cp -R "$SRC_DIR"/. "$TARGET_DIR"/
+chmod +x "$TARGET_DIR/bin/cdx"
+ln -sfn "$TARGET_DIR/bin/cdx" "$BIN_DIR/cdx"
+
+echo "Installed cdx $TAG to $TARGET_DIR"
+echo "Linked $BIN_DIR/cdx"
+case ":$PATH:" in
+  *":$BIN_DIR:"*) ;;
+  *)
+    echo "Add $BIN_DIR to PATH to run cdx from anywhere." >&2
+    ;;
+esac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdx-manager",
-  "version": "0.2.1",
+  "version": "0.3.2",
   "description": "Terminal session manager for Codex and Claude accounts.",
   "license": "MIT",
   "author": "Alexandre Agostini",
@@ -27,6 +27,8 @@
     "bin",
     "changelogs",
     "src",
+    "install.sh",
+    "pyproject.toml",
     "README.md",
     "LICENSE"
   ],

package/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cdx-manager"
+version = "0.3.2"
+description = "Terminal session manager for Codex and Claude accounts."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  { name = "Alexandre Agostini" }
+]
+keywords = ["codex", "claude", "cli", "terminal", "session-manager", "ai-tools"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development",
+  "Topic :: Terminals",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/AlexAgo83/cdx-manager"
+Repository = "https://github.com/AlexAgo83/cdx-manager.git"
+Issues = "https://github.com/AlexAgo83/cdx-manager/issues"
+Changelog = "https://github.com/AlexAgo83/cdx-manager/tree/main/changelogs"
+
+[project.scripts]
+cdx = "cdx_manager.cli:cli_entry"
+
+[tool.setuptools]
+packages = ["cdx_manager"]
+
+[tool.setuptools.package-dir]
+cdx_manager = "src"

package/src/cli.py

@@ -39,7 +39,7 @@ from .status_view import (
     _format_status_rows,
 )
 
-VERSION = "0.2.1"
+VERSION = "0.3.2"
 
 
 # ---------------------------------------------------------------------------
@@ -180,9 +180,13 @@ def main(argv, options=None):
     raise CdxError(f"Unknown command: {command}. Use cdx --help.")
 
 
-if __name__ == "__main__":
+def cli_entry():
     try:
         raise SystemExit(main(sys.argv[1:]))
     except CdxError as error:
         sys.stderr.write(f"{format_error(error)}\n")
         raise SystemExit(error.exit_code)
+
+
+if __name__ == "__main__":
+    cli_entry()