feat: Complete LLMX v0.1.0 - Rebrand from Codex with LiteLLM Integration

This release represents a comprehensive transformation of the codebase from Codex to LLMX,
enhanced with LiteLLM integration to support 100+ LLM providers through a unified API.

## Major Changes

### Phase 1: Repository & Infrastructure Setup
- Established new repository structure and branching strategy
- Created comprehensive project documentation (CLAUDE.md, LITELLM-SETUP.md)
- Set up development environment and tooling configuration

### Phase 2: Rust Workspace Transformation
- Renamed all Rust crates from `codex-*` to `llmx-*` (30+ crates)
- Updated package names, binary names, and workspace members
- Renamed core modules: codex.rs → llmx.rs, codex_delegate.rs → llmx_delegate.rs
- Updated all internal references, imports, and type names
- Renamed directories: codex-rs/ → llmx-rs/, codex-backend-openapi-models/ → llmx-backend-openapi-models/
- Fixed all Rust compilation errors after mass rename

### Phase 3: LiteLLM Integration
- Integrated LiteLLM for multi-provider LLM support (Anthropic, OpenAI, Azure, Google AI, AWS Bedrock, etc.)
- Implemented OpenAI-compatible Chat Completions API support
- Added model family detection and provider-specific handling
- Updated authentication to support LiteLLM API keys
- Renamed environment variables: OPENAI_BASE_URL → LLMX_BASE_URL
- Added LLMX_API_KEY for unified authentication
- Enhanced error handling for Chat Completions API responses
- Implemented fallback mechanisms between Responses API and Chat Completions API

### Phase 4: TypeScript/Node.js Components
- Renamed npm package: @codex/codex-cli → @valknar/llmx
- Updated TypeScript SDK to use new LLMX APIs and endpoints
- Fixed all TypeScript compilation and linting errors
- Updated SDK tests to support both API backends
- Enhanced mock server to handle multiple API formats
- Updated build scripts for cross-platform packaging

### Phase 5: Configuration & Documentation
- Updated all configuration files to use LLMX naming
- Rewrote README and documentation for LLMX branding
- Updated config paths: ~/.codex/ → ~/.llmx/
- Added comprehensive LiteLLM setup guide
- Updated all user-facing strings and help text
- Created release plan and migration documentation

### Phase 6: Testing & Validation
- Fixed all Rust tests for new naming scheme
- Updated snapshot tests in TUI (36 frame files)
- Fixed authentication storage tests
- Updated Chat Completions payload and SSE tests
- Fixed SDK tests for new API endpoints
- Ensured compatibility with Claude Sonnet 4.5 model
- Fixed test environment variables (LLMX_API_KEY, LLMX_BASE_URL)

### Phase 7: Build & Release Pipeline
- Updated GitHub Actions workflows for LLMX binary names
- Fixed rust-release.yml to reference llmx-rs/ instead of codex-rs/
- Updated CI/CD pipelines for new package names
- Made Apple code signing optional in release workflow
- Enhanced npm packaging resilience for partial platform builds
- Added Windows sandbox support to workspace
- Updated dotslash configuration for new binary names

### Phase 8: Final Polish
- Renamed all assets (.github images, labels, templates)
- Updated VSCode and DevContainer configurations
- Fixed all clippy warnings and formatting issues
- Applied cargo fmt and prettier formatting across codebase
- Updated issue templates and pull request templates
- Fixed all remaining UI text references

## Technical Details

**Breaking Changes:**
- Binary name changed from `codex` to `llmx`
- Config directory changed from `~/.codex/` to `~/.llmx/`
- Environment variables renamed (CODEX_* → LLMX_*)
- npm package renamed to `@valknar/llmx`

**New Features:**
- Support for 100+ LLM providers via LiteLLM
- Unified authentication with LLMX_API_KEY
- Enhanced model provider detection and handling
- Improved error handling and fallback mechanisms

**Files Changed:**
- 578 files modified across Rust, TypeScript, and documentation
- 30+ Rust crates renamed and updated
- Complete rebrand of UI, CLI, and documentation
- All tests updated and passing

**Dependencies:**
- Updated Cargo.lock with new package names
- Updated npm dependencies in llmx-cli
- Enhanced OpenAPI models for LLMX backend

This release establishes LLMX as a standalone project with comprehensive LiteLLM
integration, maintaining full backward compatibility with existing functionality
while opening support for a wide ecosystem of LLM providers.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Sebastian Krüger <support@pivoine.art>

sdk/typescript/src/codexOptions.ts

@@ -1,5 +0,0 @@
-export type CodexOptions = {
-  codexPathOverride?: string;
-  baseUrl?: string;
-  apiKey?: string;
-};

sdk/typescript/src/events.ts

@@ -1,4 +1,4 @@
-// based on event types from codex-rs/exec/src/exec_events.rs
+// based on event types from llmx-rs/exec/src/exec_events.rs
 
 import type { ThreadItem } from "./items";
 
@@ -68,7 +68,7 @@ export type ThreadErrorEvent = {
   message: string;
 };
 
-/** Top-level JSONL events emitted by codex exec. */
+/** Top-level JSONL events emitted by llmx exec. */
 export type ThreadEvent =
   | ThreadStartedEvent
   | TurnStartedEvent

sdk/typescript/src/exec.ts

@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url";
 
 import { SandboxMode, ModelReasoningEffort, ApprovalMode } from "./threadOptions";
 
-export type CodexExecArgs = {
+export type LLMXExecArgs = {
   input: string;
 
   baseUrl?: string;
@@ -32,16 +32,16 @@ export type CodexExecArgs = {
   approvalPolicy?: ApprovalMode;
 };
 
-const INTERNAL_ORIGINATOR_ENV = "CODEX_INTERNAL_ORIGINATOR_OVERRIDE";
-const TYPESCRIPT_SDK_ORIGINATOR = "codex_sdk_ts";
+const INTERNAL_ORIGINATOR_ENV = "LLMX_INTERNAL_ORIGINATOR_OVERRIDE";
+const TYPESCRIPT_SDK_ORIGINATOR = "llmx_sdk_ts";
 
-export class CodexExec {
+export class LLMXExec {
   private executablePath: string;
   constructor(executablePath: string | null = null) {
-    this.executablePath = executablePath || findCodexPath();
+    this.executablePath = executablePath || findLLMXPath();
   }
 
-  async *run(args: CodexExecArgs): AsyncGenerator<string> {
+  async *run(args: LLMXExecArgs): AsyncGenerator<string> {
     const commandArgs: string[] = ["exec", "--experimental-json"];
 
     if (args.model) {
@@ -97,10 +97,10 @@ export class CodexExec {
       env[INTERNAL_ORIGINATOR_ENV] = TYPESCRIPT_SDK_ORIGINATOR;
     }
     if (args.baseUrl) {
-      env.OPENAI_BASE_URL = args.baseUrl;
+      env.LLMX_BASE_URL = args.baseUrl;
     }
     if (args.apiKey) {
-      env.CODEX_API_KEY = args.apiKey;
+      env.LLMX_API_KEY = args.apiKey;
     }
 
     const child = spawn(this.executablePath, commandArgs, {
@@ -147,7 +147,7 @@ export class CodexExec {
           } else {
             const stderrBuffer = Buffer.concat(stderrChunks);
             reject(
-              new Error(`Codex Exec exited with code ${code}: ${stderrBuffer.toString("utf8")}`),
+              new Error(`LLMX Exec exited with code ${code}: ${stderrBuffer.toString("utf8")}`),
             );
           }
         });
@@ -170,7 +170,7 @@ export class CodexExec {
 const scriptFileName = fileURLToPath(import.meta.url);
 const scriptDirName = path.dirname(scriptFileName);
 
-function findCodexPath() {
+function findLLMXPath() {
   const { platform, arch } = process;
 
   let targetTriple = null;
@@ -222,8 +222,8 @@ function findCodexPath() {
 
   const vendorRoot = path.join(scriptDirName, "..", "vendor");
   const archRoot = path.join(vendorRoot, targetTriple);
-  const codexBinaryName = process.platform === "win32" ? "codex.exe" : "codex";
-  const binaryPath = path.join(archRoot, "codex", codexBinaryName);
+  const llmxBinaryName = process.platform === "win32" ? "llmx.exe" : "llmx";
+  const binaryPath = path.join(archRoot, "llmx", llmxBinaryName);
 
   return binaryPath;
 }

sdk/typescript/src/index.ts

@@ -26,9 +26,9 @@ export type {
 export { Thread } from "./thread";
 export type { RunResult, RunStreamedResult, Input, UserInput } from "./thread";
 
-export { Codex } from "./codex";
+export { LLMX } from "./llmx";
 
-export type { CodexOptions } from "./codexOptions";
+export type { LLMXOptions } from "./llmxOptions";
 
 export type {
   ThreadOptions,

sdk/typescript/src/items.ts

@@ -1,4 +1,4 @@
-// based on item types from codex-rs/exec/src/exec_events.rs
+// based on item types from llmx-rs/exec/src/exec_events.rs
 
 import type { ContentBlock as McpContentBlock } from "@modelcontextprotocol/sdk/types.js";
 

sdk/typescript/src/llmx.ts

@@ -1,19 +1,19 @@
-import { CodexOptions } from "./codexOptions";
-import { CodexExec } from "./exec";
+import { LLMXOptions } from "./llmxOptions";
+import { LLMXExec } from "./exec";
 import { Thread } from "./thread";
 import { ThreadOptions } from "./threadOptions";
 
 /**
- * Codex is the main class for interacting with the Codex agent.
+ * LLMX is the main class for interacting with the LLMX agent.
  *
  * Use the `startThread()` method to start a new thread or `resumeThread()` to resume a previously started thread.
  */
-export class Codex {
-  private exec: CodexExec;
-  private options: CodexOptions;
+export class LLMX {
+  private exec: LLMXExec;
+  private options: LLMXOptions;
 
-  constructor(options: CodexOptions = {}) {
-    this.exec = new CodexExec(options.codexPathOverride);
+  constructor(options: LLMXOptions = {}) {
+    this.exec = new LLMXExec(options.llmxPathOverride);
     this.options = options;
   }
 
@@ -27,7 +27,7 @@ export class Codex {
 
   /**
    * Resumes a conversation with an agent based on the thread id.
-   * Threads are persisted in ~/.codex/sessions.
+   * Threads are persisted in ~/.llmx/sessions.
    *
    * @param id The id of the thread to resume.
    * @returns A new thread instance.

sdk/typescript/src/llmxOptions.ts

@@ -0,0 +1,5 @@
+export type LLMXOptions = {
+  llmxPathOverride?: string;
+  baseUrl?: string;
+  apiKey?: string;
+};

sdk/typescript/src/outputSchemaFile.ts

@@ -16,7 +16,7 @@ export async function createOutputSchemaFile(schema: unknown): Promise<OutputSch
     throw new Error("outputSchema must be a plain JSON object");
   }
 
-  const schemaDir = await fs.mkdtemp(path.join(os.tmpdir(), "codex-output-schema-"));
+  const schemaDir = await fs.mkdtemp(path.join(os.tmpdir(), "llmx-output-schema-"));
   const schemaPath = path.join(schemaDir, "schema.json");
   const cleanup = async () => {
     try {

sdk/typescript/src/thread.ts

@@ -1,6 +1,6 @@
-import { CodexOptions } from "./codexOptions";
+import { LLMXOptions } from "./llmxOptions";
 import { ThreadEvent, ThreadError, Usage } from "./events";
-import { CodexExec } from "./exec";
+import { LLMXExec } from "./exec";
 import { ThreadItem } from "./items";
 import { ThreadOptions } from "./threadOptions";
 import { TurnOptions } from "./turnOptions";
@@ -39,8 +39,8 @@ export type Input = string | UserInput[];
 
 /** Respesent a thread of conversation with the agent. One thread can have multiple consecutive turns. */
 export class Thread {
-  private _exec: CodexExec;
-  private _options: CodexOptions;
+  private _exec: LLMXExec;
+  private _options: LLMXOptions;
   private _id: string | null;
   private _threadOptions: ThreadOptions;
 
@@ -51,8 +51,8 @@ export class Thread {
 
   /* @internal */
   constructor(
-    exec: CodexExec,
-    options: CodexOptions,
+    exec: LLMXExec,
+    options: LLMXOptions,
     threadOptions: ThreadOptions,
     id: string | null = null,
   ) {