@minniexcode/codex-switch 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 minniexcode
+
+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,171 @@
+# @minniexcode/codex-switch
+
+`@minniexcode/codex-switch` is a local-first CLI for managing and switching Codex provider/profile configuration safely.
+
+Current product direction:
+
+- CLI-first
+- local-first
+- safe by default
+- AI-friendly
+
+The intended command name is:
+
+```bash
+codexs
+```
+
+## Status
+
+This scoped package is currently being reserved and scaffolded for the first public release.
+
+The product scope is already defined, but the full CLI feature set is not implemented yet. The first published versions may be bootstrap releases used to reserve the npm package name and establish the command entrypoint.
+
+If you install the package now, expect a minimal CLI shell rather than the complete switching workflow.
+The project is scaffolded as a TypeScript CLI and publishes compiled output from `dist/`.
+
+## Why This Exists
+
+Managing multiple Codex providers or profiles locally usually falls into two bad options:
+
+- ad hoc scripts that work once but are hard to maintain
+- heavier account or desktop tools that solve a broader problem than local switching
+
+`@minniexcode/codex-switch` sits between those extremes. It aims to provide a stable CLI interface for:
+
+- viewing the current Codex profile
+- listing locally configured providers
+- switching providers safely
+- backing up config before mutation
+- rolling back on failure
+- importing and exporting provider mappings
+- returning structured output for automation and AI agents
+
+## Product Definition
+
+`@minniexcode/codex-switch` is intended to manage files under `~/.codex/`:
+
+```text
+~/.codex/
+  config.toml
+  auth.json
+  providers.json
+  backups/
+```
+
+Core design principles:
+
+- `config.toml` remains the source of the active top-level `profile`
+- `providers.json` stores provider-to-profile and provider-to-key mappings
+- all writes should be backed up first
+- failures should trigger rollback
+- CLI output should stay stable and machine-readable
+
+## Planned MVP
+
+The planned MVP command surface is:
+
+```bash
+codexs list
+codexs current
+codexs switch <provider>
+codexs status
+codexs import <file>
+codexs export <file>
+codexs add <provider>
+codexs remove <provider>
+codexs doctor
+codexs rollback
+```
+
+Planned shared flags:
+
+```bash
+--json
+--codex-dir <path>
+```
+
+## Example Provider Model
+
+Planned `providers.json` shape:
+
+```json
+{
+  "providers": {
+    "packycode": {
+      "profile": "packycode",
+      "apiKey": "sk-xxx",
+      "baseUrl": "https://example.com/v1",
+      "note": "primary free model route",
+      "tags": ["free", "daily"]
+    }
+  }
+}
+```
+
+`providers.json` should be treated as a local secret because it may contain API keys.
+
+## Install
+
+Global install:
+
+```bash
+npm install -g @minniexcode/codex-switch
+```
+
+One-off execution:
+
+```bash
+npx @minniexcode/codex-switch
+```
+
+Current bootstrap behavior:
+
+```bash
+codexs --help
+```
+
+## Current Repository Contents
+
+This repository currently contains the product definition and PRD used to shape the first implementation:
+
+- [Product Overview](./docs/codex-switch-product-overview.md)
+- [Product Research](./docs/codex-switch-product-research.md)
+- [PRD](./docs/codex-switch-prd.md)
+
+## Roadmap
+
+Near-term priorities:
+
+- publish the package name and CLI entrypoint
+- implement provider storage and validation
+- implement config backup and rollback
+- implement safe switching flow around `config.toml`
+- support structured `--json` output for automation
+- add cross-platform tests for Windows, macOS, and Linux paths
+
+## Non-Goals for MVP
+
+The first version is not trying to be:
+
+- a GUI or desktop app
+- a background daemon
+- a full account management platform
+- a proxy/router layer
+- a remote sync service
+
+## Development
+
+At this stage the package is a bootstrap CLI shell. The implementation will follow the product documents in `docs/`.
+
+Local development:
+
+```bash
+npm install
+npm run build
+node dist/cli.js --help
+```
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+const args = process.argv.slice(2);
+const version = "0.0.1";
+const helpText = `codex-switch
+
+Bootstrap release for the future Codex provider/profile switching CLI.
+
+Usage:
+  codexs
+  codexs --help
+  codexs --version
+
+Status:
+  This package currently reserves the npm scope and exposes the planned CLI entrypoint.
+  The full switching workflow is not implemented yet.
+
+Docs:
+  https://github.com/minniexcode/codex-switch
+`;
+if (args.includes("--version") || args.includes("-v")) {
+    console.log(version);
+    process.exit(0);
+}
+if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+    console.log(helpText);
+    process.exit(0);
+}
+console.error(`Command not implemented yet: ${args.join(" ")}\nRun "codexs --help" for the current bootstrap status.`);
+process.exit(1);