@happycastle/codex-litellm 0.7.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yusef Mohamadi (@yuseferi)
+
+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,37 @@
+# @happycastle/codex-litellm
+
+Thin Codex-focused wrapper for
+[`@happycastle/opencode-litellm`](https://github.com/happycastle114/opencode-litellm).
+Defaults `install` to `--target codex`; everything else is forwarded to the
+core CLI.
+
+## Quick start
+
+```bash
+# Install for Codex (interactive)
+npx @happycastle/codex-litellm install
+
+# Install for both Codex and OpenCode
+npx @happycastle/codex-litellm install --target both
+
+# Launch Codex with the installed config
+npx @happycastle/opencode-litellm codex
+```
+
+## What it does
+
+- Prompts for LiteLLM gateway URL, auth (SSO or env key), and Codex mode
+  (`gateway`, `oauth`, or `both`)
+- Discovers models, search tools, MCP servers, and toolsets
+- Writes Codex config + model catalog
+- Installs the shared research skill at `~/.agents/skills/litellm-research-router/`
+
+## Requirements
+
+- Node.js `^22.22.2 || ^24.15.0 || >=26.0.0`
+- Codex installed
+- A reachable LiteLLM gateway
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/bin/codex-litellm.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process'
+import { createRequire } from 'node:module'
+
+const CLI_ARGUMENT = Object.freeze({
+  Install: 'install',
+  TargetOption: '--target',
+  CodexTarget: 'codex',
+})
+
+const require = createRequire(import.meta.url)
+const cliPath = require.resolve('@happycastle/opencode-litellm/cli')
+const args = process.argv.slice(2)
+const forwardedArgs = args[0] === CLI_ARGUMENT.Install && !args.includes(CLI_ARGUMENT.TargetOption)
+  ? [
+      CLI_ARGUMENT.Install,
+      CLI_ARGUMENT.TargetOption,
+      CLI_ARGUMENT.CodexTarget,
+      ...args.slice(1),
+    ]
+  : args
+const child = spawn(process.execPath, [cliPath, ...forwardedArgs], {
+  stdio: 'inherit',
+})
+
+child.on('error', () => {
+  process.exitCode = 1
+})
+child.on('exit', (code, signal) => {
+  if (signal !== null) {
+    process.kill(process.pid, signal)
+    return
+  }
+  process.exitCode = code ?? 1
+})

package/package.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@happycastle/codex-litellm",
+  "version": "0.7.1",
+  "description": "Codex-compatible command wrapper for the happycastle114 LiteLLM plugin",
+  "type": "module",
+  "bin": {
+    "codex-litellm": "./bin/codex-litellm.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/happycastle114/opencode-litellm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/happycastle114/opencode-litellm/issues"
+  },
+  "homepage": "https://github.com/happycastle114/opencode-litellm#readme",
+  "dependencies": {
+    "@happycastle/opencode-litellm": "0.7.1"
+  }
+}