@alphaedge/codex-profile 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 REPO_OWNER
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# codex-profile
+
+CLI to switch between Codex config/auth profiles.
+
+It manages these files in your Codex home (`$CODEX_HOME`, `~/.config/codex`, or `~/.codex`):
+
+- `config.toml`
+- `auth.json`
+
+Profiles are stored as sibling files with a suffix:
+
+- `config.toml.<profile>`
+- `auth.json.<profile>`
+
+## Install
+
+### npm
+
+```bash
+npm i -g @alphaedge/codex-profile
+```
+
+### Homebrew
+
+```bash
+brew tap REPO_OWNER/codex-profile
+brew install codex-profile
+```
+
+## Usage
+
+```bash
+codex-profile show
+codex-profile save openai
+codex-profile switch openai
+codex-profile switch bk
+```
+
+`switch` creates a timestamped backup in `profile_backups/<timestamp>/` by default.
+
+## Release to npm
+
+1. Update `version` in `package.json`.
+2. Commit + tag:
+   ```bash
+   git tag v0.1.0
+   git push origin main --tags
+   ```
+3. Publish:
+   ```bash
+   npm login
+   npm publish
+   ```
+
+## Release to Homebrew
+
+1. Create tap repo named `homebrew-codex-profile` under your GitHub account.
+2. Copy `Formula/codex-profile.rb` into that tap repo at `Formula/codex-profile.rb`.
+3. Replace placeholders:
+   - `REPO_OWNER`
+   - `REPO_VERSION`
+   - `REPO_SHA256`
+4. Compute tarball sha256:
+   ```bash
+   curl -L https://github.com/REPO_OWNER/codex-profile/archive/refs/tags/vREPO_VERSION.tar.gz | shasum -a 256
+   ```
+5. Commit formula change in the tap repo.
+
+## Local dev
+
+```bash
+./bin/codex-profile --help
+./bin/codex-profile show
+```

package/bin/codex-profile

@@ -0,0 +1,282 @@
+#!/usr/bin/env python3
+"""Manage Codex config/auth profile files.
+
+Profiles are stored as sibling files in the Codex home:
+- config.toml.<profile>
+- auth.json.<profile>
+
+Example:
+- config.toml.bk + auth.json.bk => profile name "bk"
+"""
+
+from __future__ import annotations
+
+import argparse
+import datetime as dt
+import hashlib
+import os
+from pathlib import Path
+import re
+import shutil
+import sys
+
+BASE_FILES = ("config.toml", "auth.json")
+
+
+class ProfileError(RuntimeError):
+    pass
+
+
+def detect_codex_home(explicit_home: str | None) -> Path:
+    candidates: list[Path] = []
+    if explicit_home:
+        candidates.append(Path(explicit_home).expanduser())
+    else:
+        env_home = os.environ.get("CODEX_HOME")
+        if env_home:
+            candidates.append(Path(env_home).expanduser())
+        candidates.extend([
+            Path.home() / ".config" / "codex",
+            Path.home() / ".codex",
+        ])
+
+    for candidate in candidates:
+        if (candidate / "config.toml").exists() or (candidate / "auth.json").exists():
+            return candidate
+    for candidate in candidates:
+        if candidate.exists():
+            return candidate
+
+    looked = ", ".join(str(p) for p in candidates)
+    raise ProfileError(f"Could not find Codex home. Checked: {looked}")
+
+
+def validate_profile_name(name: str) -> None:
+    if not re.fullmatch(r"[A-Za-z0-9_.-]+", name):
+        raise ProfileError(
+            "Invalid profile name. Use letters, numbers, dash, underscore, or dot."
+        )
+
+
+def file_digest(path: Path) -> str:
+    h = hashlib.sha256()
+    with path.open("rb") as f:
+        for chunk in iter(lambda: f.read(65536), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+
+def parse_toml_value(text: str, key: str) -> str:
+    # Minimal parser for top-level key = "value" lines.
+    pattern = rf"(?m)^\s*{re.escape(key)}\s*=\s*\"([^\"]+)\"\s*$"
+    match = re.search(pattern, text)
+    return match.group(1).strip() if match else "?"
+
+
+def parse_provider_base_url(text: str, provider: str) -> str:
+    if provider == "?":
+        return ""
+    section = re.search(
+        rf"(?ms)^\s*\[model_providers\.{re.escape(provider)}\]\s*(.*?)(?=^\s*\[|\Z)",
+        text,
+    )
+    if not section:
+        return ""
+    body = section.group(1)
+    match = re.search(r'(?m)^\s*base_url\s*=\s*"([^"]+)"\s*$', body)
+    return match.group(1).strip() if match else ""
+
+
+def load_provider_summary(config_path: Path) -> str:
+    try:
+        text = config_path.read_text(encoding="utf-8", errors="ignore")
+    except Exception:
+        return "provider=? model=?"
+
+    provider = parse_toml_value(text, "model_provider")
+    model = parse_toml_value(text, "model")
+    base_url = parse_provider_base_url(text, provider)
+
+    if base_url:
+        return f"provider={provider} model={model} base_url={base_url}"
+    return f"provider={provider} model={model}"
+
+
+def profile_paths(home: Path, profile: str) -> dict[str, Path]:
+    return {base: home / f"{base}.{profile}" for base in BASE_FILES}
+
+
+def collect_profiles(home: Path) -> dict[str, dict[str, Path]]:
+    found: dict[str, dict[str, Path]] = {}
+    for base in BASE_FILES:
+        for file_path in home.glob(f"{base}.*"):
+            profile = file_path.name[len(base) + 1 :]
+            if not profile:
+                continue
+            found.setdefault(profile, {})[base] = file_path
+    return found
+
+
+def atomic_copy(src: Path, dst: Path) -> None:
+    tmp = dst.with_name(dst.name + ".tmp")
+    shutil.copy2(src, tmp)
+    os.replace(tmp, dst)
+
+
+def backup_active(home: Path) -> Path:
+    stamp = dt.datetime.now().strftime("%Y%m%d-%H%M%S")
+    backup_dir = home / "profile_backups" / stamp
+    backup_dir.mkdir(parents=True, exist_ok=False)
+    for base in BASE_FILES:
+        src = home / base
+        if src.exists():
+            shutil.copy2(src, backup_dir / base)
+    return backup_dir
+
+
+def cmd_show(home: Path) -> int:
+    config_path = home / "config.toml"
+    auth_path = home / "auth.json"
+
+    print(f"Codex home: {home}")
+    if config_path.exists():
+        print(f"Active config: {config_path}")
+        print(f"  {load_provider_summary(config_path)}")
+    else:
+        print("Active config: missing")
+
+    if auth_path.exists():
+        print(f"Active auth: {auth_path}")
+    else:
+        print("Active auth: missing")
+
+    profiles = collect_profiles(home)
+    if not profiles:
+        print("Profiles: none")
+        return 0
+
+    active_digests: dict[str, str] = {}
+    for base in BASE_FILES:
+        p = home / base
+        if p.exists():
+            active_digests[base] = file_digest(p)
+
+    print("Profiles:")
+    for name in sorted(profiles):
+        files = profiles[name]
+        has_all = all(base in files for base in BASE_FILES)
+        status = "ok" if has_all else "incomplete"
+
+        active_match = False
+        if has_all and active_digests:
+            active_match = all(
+                active_digests.get(base) == file_digest(files[base])
+                for base in BASE_FILES
+                if base in active_digests
+            )
+
+        marker = "*" if active_match else " "
+        summary = ""
+        if "config.toml" in files:
+            summary = load_provider_summary(files["config.toml"])
+        print(f" {marker} {name:<18} [{status}] {summary}".rstrip())
+
+    return 0
+
+
+def cmd_save(home: Path, profile: str, force: bool) -> int:
+    validate_profile_name(profile)
+    src_paths = {base: home / base for base in BASE_FILES}
+    for base, path in src_paths.items():
+        if not path.exists():
+            raise ProfileError(f"Missing active {base}: {path}")
+
+    dst_paths = profile_paths(home, profile)
+    if not force:
+        existing = [str(p) for p in dst_paths.values() if p.exists()]
+        if existing:
+            joined = ", ".join(existing)
+            raise ProfileError(f"Profile already exists. Use --force to overwrite: {joined}")
+
+    for base in BASE_FILES:
+        atomic_copy(src_paths[base], dst_paths[base])
+
+    print(f"Saved active files to profile '{profile}'.")
+    return 0
+
+
+def cmd_switch(home: Path, profile: str, no_backup: bool) -> int:
+    validate_profile_name(profile)
+    src_paths = profile_paths(home, profile)
+
+    missing = [str(p) for p in src_paths.values() if not p.exists()]
+    if missing:
+        expected = ", ".join(str(p) for p in src_paths.values())
+        raise ProfileError(
+            f"Profile files missing for profile '{profile}'. Expected: {expected}"
+        )
+
+    if no_backup:
+        print("Skipping backup (--no-backup).")
+    else:
+        backup_dir = backup_active(home)
+        print(f"Backed up active files to: {backup_dir}")
+
+    for base in BASE_FILES:
+        atomic_copy(src_paths[base], home / base)
+
+    print(f"Switched active Codex config to profile '{profile}'.")
+    print(f"  {load_provider_summary(home / 'config.toml')}")
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="codex-profile",
+        description="Manage Codex config/auth profile files.",
+    )
+    parser.add_argument(
+        "--home",
+        help="Codex home dir (defaults: $CODEX_HOME, ~/.config/codex, ~/.codex).",
+    )
+
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("show", help="Show active config and discovered profiles.")
+
+    p_save = sub.add_parser("save", help="Save active config/auth as a named profile.")
+    p_save.add_argument("profile", help="Profile name, e.g. openai, local, bk")
+    p_save.add_argument("--force", action="store_true", help="Overwrite existing profile")
+
+    p_switch = sub.add_parser("switch", help="Switch active config/auth to a profile.")
+    p_switch.add_argument("profile", help="Profile name, e.g. openai, local, bk")
+    p_switch.add_argument(
+        "--no-backup",
+        action="store_true",
+        help="Do not save a timestamped backup before switching.",
+    )
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        home = detect_codex_home(args.home)
+        if args.command == "show":
+            return cmd_show(home)
+        if args.command == "save":
+            return cmd_save(home, args.profile, args.force)
+        if args.command == "switch":
+            return cmd_switch(home, args.profile, args.no_backup)
+        parser.print_help()
+        return 1
+    except ProfileError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@alphaedge/codex-profile",
+  "version": "0.1.0",
+  "description": "Switch between Codex config/auth profiles",
+  "license": "MIT",
+  "bin": {
+    "codex-profile": "bin/codex-profile"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "codex",
+    "cli",
+    "config"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/REPO_OWNER/codex-profile.git"
+  },
+  "bugs": {
+    "url": "https://github.com/REPO_OWNER/codex-profile/issues"
+  },
+  "homepage": "https://github.com/REPO_OWNER/codex-profile#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}