codex-mirror 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 codex-mirror contributors
+
+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,154 @@
+# codex-mirror
+
+`codex-mirror` is a local multi-account manager for Codex.  
+It creates centrally stored clones, each with isolated runtime and isolated auth/session/config state.
+
+This project currently targets **official Codex only** (Phase 1). Multi-provider support is planned for Phase 2.
+
+> Unofficial community tool. Not affiliated with OpenAI.
+
+## What you get
+
+- Screen-based TUI (`codex-mirror`) with clone lifecycle management
+- Centralized clone storage under one global home
+- Per-clone runtime pinning (copied from currently installed Codex)
+- Per-clone isolated `HOME` and XDG directories
+- Wrapper command per clone name
+- Built-in diagnostics (`doctor`) for runtime/wrapper/writable/auth checks
+- Safety protections:
+  - Strict clone-name validation
+  - Wrapper path confinement (no path traversal)
+  - Registry lock + atomic writes
+  - Transactional clone create/update/remove with rollback
+
+## Requirements
+
+- macOS/Linux (Node.js 20+)
+- `codex` available on `PATH`
+
+## Quick start
+
+```bash
+npm install
+npm run build
+node dist/cli.js
+```
+
+Global install (after publish):
+
+```bash
+npm install -g codex-mirror
+codex-mirror
+```
+
+From the TUI:
+1. Choose `Quick Clone` or `New Clone Wizard`.
+2. Optionally run login for that clone.
+3. Use `Manage Clones` to run, update, remove.
+4. Use `Diagnostics` for health checks.
+
+## CLI usage
+
+```bash
+# Create clone (default root: ~/.codex-mirror/clones/<name>)
+node dist/cli.js create --name work
+
+# List clones
+node dist/cli.js list
+node dist/cli.js list --full
+node dist/cli.js list --json
+
+# Run clone
+node dist/cli.js run work
+node dist/cli.js run work -- --model o3
+
+# Login/logout
+node dist/cli.js login work
+node dist/cli.js logout work
+
+# Health checks
+node dist/cli.js doctor
+node dist/cli.js doctor work --json
+
+# Updates
+node dist/cli.js update work
+node dist/cli.js update --all
+
+# Remove clone
+node dist/cli.js remove work
+
+# Reinstall wrappers
+node dist/cli.js wrapper install
+```
+
+## Data layout
+
+Default locations:
+
+- Mirror home: `~/.codex-mirror`
+- Registry: `~/.codex-mirror/registry.json`
+- Clone root: `~/.codex-mirror/clones/<clone-name>`
+- Wrapper binaries: `~/.local/bin/<clone-name>`
+
+Per clone:
+
+```text
+<clone-root>/
+  .codex-mirror/
+    clone.json
+    runtime/
+    home/
+      .codex/
+      .config/
+      .local/share/
+      .cache/
+    logs/
+```
+
+Path overrides:
+
+- `CODEX_MIRROR_HOME` (changes global root)
+- `CODEX_MIRROR_BIN_DIR` (changes wrapper output dir)
+
+## Safety model
+
+- Clone names are validated and must be filesystem-safe.
+- Wrapper paths are forced to remain inside configured wrapper directory.
+- Registry updates are lock-protected and written atomically.
+- Create/update/remove operations include rollback to avoid partial state.
+- Health checks use bounded concurrency and auth timeouts.
+
+Detailed docs:
+
+- `docs/ARCHITECTURE.md`
+- `docs/SECURITY.md`
+- `docs/OPERATIONS.md`
+- `docs/TROUBLESHOOTING.md`
+- `docs/ROADMAP.md`
+- `docs/RELEASE.md`
+
+## Development
+
+```bash
+npm run check
+```
+
+## Community
+
+- Contributing guide: `CONTRIBUTING.md`
+- Code of Conduct: `CODE_OF_CONDUCT.md`
+- Security policy: `SECURITY.md`
+- Support info: `SUPPORT.md`
+
+## Maintainer release flow
+
+1. Ensure `main` is green in CI.
+2. Update version:
+   ```bash
+   npm version patch
+   ```
+3. Push commit + tag:
+   ```bash
+   git push origin main --follow-tags
+   ```
+4. Tag trigger `v*` will run `.github/workflows/release.yml` and publish to npm.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { CloneManager } from "./core/clone-manager.js";
+import { assertValidCloneName, sanitizeCloneName } from "./core/clone-name.js";
+import { resolveContext } from "./core/context.js";
+import { Doctor } from "./core/doctor.js";
+import { Launcher } from "./core/launcher.js";
+import { RegistryStore } from "./core/registry.js";
+import { WrapperManager } from "./core/wrapper-manager.js";
+import { runTui } from "./tui/index.js";
+async function main() {
+    const cliVersion = await resolveCliVersion();
+    const context = resolveContext();
+    const wrapperRunner = resolveWrapperRunner();
+    const registry = new RegistryStore(context.registryPath);
+    const wrappers = new WrapperManager(context.defaultBinDir, wrapperRunner);
+    const cloneManager = new CloneManager(registry, wrappers);
+    const launcher = new Launcher();
+    const doctor = new Doctor(launcher);
+    const program = new Command();
+    program
+        .name("codex-mirror")
+        .version(cliVersion, "-V, --version", "Output version")
+        .description("Manage centrally-stored isolated Codex clones with independent auth/session state")
+        .option("--debug", "Enable debug logging")
+        .showHelpAfterError();
+    program
+        .command("create")
+        .description("Create a new clone")
+        .requiredOption("--name <name>", "Clone name")
+        .option("--root <path>", "Advanced: custom clone storage directory (default: ~/.codex-mirror/clones/<name>)")
+        .action(async (options) => {
+        const cloneName = assertValidCloneName(options.name);
+        const rootPath = options.root
+            ? options.root
+            : resolve(context.globalRoot, "clones", sanitizeCloneName(cloneName));
+        const clone = await cloneManager.createClone({
+            name: cloneName,
+            rootPath,
+        });
+        console.log(`Created clone '${clone.name}' at ${clone.rootPath}`);
+        console.log(`Wrapper: ${clone.wrapperPath}`);
+    });
+    program
+        .command("list")
+        .description("List clones")
+        .option("--json", "Emit JSON output")
+        .option("--full", "Show full metadata")
+        .action(async (options) => {
+        const clones = await cloneManager.listClones();
+        if (options.json) {
+            console.log(JSON.stringify(clones, null, 2));
+            return;
+        }
+        if (clones.length === 0) {
+            console.log("No clones found.");
+            return;
+        }
+        if (options.full) {
+            for (const clone of clones) {
+                console.log(`${clone.name}`);
+                console.log(`  root: ${clone.rootPath}`);
+                console.log(`  version: ${clone.codexVersionPinned}`);
+                console.log(`  runtime: ${clone.runtimeEntryPath}`);
+                console.log(`  wrapper: ${clone.wrapperPath}`);
+                console.log(`  created: ${clone.createdAt}`);
+                console.log(`  updated: ${clone.updatedAt}`);
+                console.log("");
+            }
+            return;
+        }
+        for (const clone of clones) {
+            console.log(`${clone.name}\t${clone.codexVersionPinned}\t${clone.rootPath}`);
+        }
+    });
+    program
+        .command("run")
+        .description("Run Codex inside a clone")
+        .argument("<name>", "Clone name")
+        .argument("[codexArgs...]", "Arguments passed to Codex")
+        .allowUnknownOption(true)
+        .action(async (name, codexArgs) => {
+        const clone = await cloneManager.getClone(name);
+        const forwarded = extractPassthroughArgs();
+        const args = forwarded.length > 0 ? forwarded : codexArgs;
+        const code = await launcher.run(clone, args, process.cwd());
+        process.exitCode = code;
+    });
+    program
+        .command("login")
+        .description("Run Codex login in clone context")
+        .argument("<name>", "Clone name")
+        .action(async (name) => {
+        const clone = await cloneManager.getClone(name);
+        const code = await launcher.run(clone, ["login"], process.cwd());
+        process.exitCode = code;
+    });
+    program
+        .command("logout")
+        .description("Run Codex logout in clone context")
+        .argument("<name>", "Clone name")
+        .action(async (name) => {
+        const clone = await cloneManager.getClone(name);
+        const code = await launcher.run(clone, ["logout"], process.cwd());
+        process.exitCode = code;
+    });
+    program
+        .command("doctor")
+        .description("Health check one or all clones")
+        .argument("[name]", "Clone name")
+        .option("--json", "Emit JSON output")
+        .action(async (name, options) => {
+        const clones = name
+            ? [await cloneManager.getClone(name)]
+            : await cloneManager.listClones();
+        const results = await doctor.checkMany(clones);
+        if (options.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        printDoctor(results);
+    });
+    program
+        .command("update")
+        .description("Update one clone or all clones to current Codex version")
+        .argument("[name]", "Clone name")
+        .option("--all", "Update all clones")
+        .action(async (name, options) => {
+        if (options.all) {
+            const updated = await cloneManager.updateAll();
+            console.log(`Updated ${updated.length} clone(s).`);
+            return;
+        }
+        if (!name) {
+            throw new Error("Provide a clone name or use --all");
+        }
+        const updated = await cloneManager.updateClone(name);
+        console.log(`Updated clone '${updated.name}' to Codex ${updated.codexVersionPinned}`);
+    });
+    program
+        .command("remove")
+        .description("Remove a clone")
+        .argument("<name>", "Clone name")
+        .action(async (name) => {
+        const removed = await cloneManager.removeClone(name);
+        console.log(`Removed clone '${removed.name}' from ${removed.rootPath}`);
+    });
+    program
+        .command("wrapper")
+        .description("Install or refresh clone wrapper scripts")
+        .command("install")
+        .description("Install wrappers for all clones")
+        .option("--bin-dir <path>", "Target wrapper directory")
+        .action(async (options) => {
+        const targetDir = options.binDir ? resolve(options.binDir) : context.defaultBinDir;
+        const scopedWrappers = new WrapperManager(targetDir, wrapperRunner);
+        const clones = await cloneManager.listClones();
+        for (const clone of clones) {
+            clone.wrapperPath = await scopedWrappers.installWrapper(clone);
+            clone.updatedAt = new Date().toISOString();
+            await cloneManager.saveClone(clone);
+        }
+        console.log(`Installed ${clones.length} wrapper(s) in ${targetDir}`);
+    });
+    const argv = process.argv.slice(2);
+    const wantsMetaOutput = argv.includes("-h") ||
+        argv.includes("--help") ||
+        argv.includes("-V") ||
+        argv.includes("--version");
+    const hasCommand = argv.some((arg) => !arg.startsWith("-"));
+    if (!hasCommand && !wantsMetaOutput) {
+        await runTui({
+            cloneManager,
+            launcher,
+            doctor,
+            defaultCloneBaseDir: resolve(context.globalRoot, "clones"),
+        });
+        return;
+    }
+    await program.parseAsync(process.argv);
+}
+function resolveWrapperRunner() {
+    const scriptPath = process.argv[1];
+    if (!scriptPath) {
+        return { command: "codex-mirror", args: [] };
+    }
+    const resolvedScriptPath = resolve(scriptPath);
+    if (/\.m?js$|\.cjs$/.test(resolvedScriptPath)) {
+        return { command: process.execPath, args: [resolvedScriptPath] };
+    }
+    return { command: resolvedScriptPath, args: [] };
+}
+function extractPassthroughArgs() {
+    const index = process.argv.indexOf("--");
+    if (index === -1) {
+        return [];
+    }
+    return process.argv.slice(index + 1);
+}
+function printDoctor(results) {
+    if (results.length === 0) {
+        console.log("No clones found.");
+        return;
+    }
+    for (const result of results) {
+        console.log(`${result.ok ? "OK" : "FAIL"} ${result.name}`);
+        console.log(`  runtime: ${result.runtimePath}`);
+        console.log(`  wrapper: ${result.wrapperPath}`);
+        console.log(`  auth: ${result.authStatus}`);
+        console.log(`  writable: ${result.writable ? "yes" : "no"}`);
+        if (result.errors.length > 0) {
+            for (const error of result.errors) {
+                console.log(`  error: ${error}`);
+            }
+        }
+        console.log("");
+    }
+}
+async function resolveCliVersion() {
+    const envVersion = process.env.npm_package_version;
+    if (envVersion && envVersion.trim().length > 0) {
+        return envVersion.trim();
+    }
+    try {
+        const packageJsonPath = new URL("../package.json", import.meta.url);
+        const raw = await readFile(packageJsonPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version && parsed.version.trim().length > 0) {
+            return parsed.version.trim();
+        }
+    }
+    catch {
+        // Fallback below if package metadata cannot be read.
+    }
+    return "0.0.0";
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core/clone-manager.d.ts

@@ -0,0 +1,21 @@
+import { ClonePaths, CloneRecord } from "../types.js";
+import { RegistryStore } from "./registry.js";
+import { WrapperManager } from "./wrapper-manager.js";
+export interface CreateCloneOptions {
+    name: string;
+    rootPath: string;
+}
+export declare class CloneManager {
+    private readonly registry;
+    private readonly wrappers;
+    constructor(registry: RegistryStore, wrappers: WrapperManager);
+    listClones(): Promise<CloneRecord[]>;
+    getClone(name: string): Promise<CloneRecord>;
+    createClone(options: CreateCloneOptions): Promise<CloneRecord>;
+    updateClone(name: string): Promise<CloneRecord>;
+    updateAll(): Promise<CloneRecord[]>;
+    removeClone(name: string): Promise<CloneRecord>;
+    saveClone(clone: CloneRecord): Promise<void>;
+    private writeCloneMetadata;
+}
+export declare function deriveClonePaths(rootPath: string): ClonePaths;