3c7efc58c8
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>
71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
# Migration to pnpm
|
|
|
|
This project has been migrated from npm to pnpm to improve dependency management and developer experience.
|
|
|
|
## Why pnpm?
|
|
|
|
- **Faster installation**: pnpm is significantly faster than npm and yarn
|
|
- **Disk space savings**: pnpm uses a content-addressable store to avoid duplication
|
|
- **Phantom dependency prevention**: pnpm creates a strict node_modules structure
|
|
- **Native workspaces support**: simplified monorepo management
|
|
|
|
## How to use pnpm
|
|
|
|
### Installation
|
|
|
|
```bash
|
|
# Global installation of pnpm
|
|
npm install -g pnpm@10.8.1
|
|
|
|
# Or with corepack (available with Node.js 22+)
|
|
corepack enable
|
|
corepack prepare pnpm@10.8.1 --activate
|
|
```
|
|
|
|
### Common commands
|
|
|
|
| npm command | pnpm equivalent |
|
|
| --------------- | ---------------- |
|
|
| `npm install` | `pnpm install` |
|
|
| `npm run build` | `pnpm run build` |
|
|
| `npm test` | `pnpm test` |
|
|
| `npm run lint` | `pnpm run lint` |
|
|
|
|
### Workspace-specific commands
|
|
|
|
| Action | Command |
|
|
| ------------------------------------------ | ------------------------------------- |
|
|
| Run a command in a specific package | `pnpm --filter @llmx/llmx run build` |
|
|
| Install a dependency in a specific package | `pnpm --filter @llmx/llmx add lodash` |
|
|
| Run a command in all packages | `pnpm -r run test` |
|
|
|
|
## Monorepo structure
|
|
|
|
```
|
|
llmx/
|
|
├── pnpm-workspace.yaml # Workspace configuration
|
|
├── .npmrc # pnpm configuration
|
|
├── package.json # Root dependencies and scripts
|
|
├── llmx-cli/ # Main package
|
|
│ └── package.json # llmx-cli specific dependencies
|
|
└── docs/ # Documentation (future package)
|
|
```
|
|
|
|
## Configuration files
|
|
|
|
- **pnpm-workspace.yaml**: Defines the packages included in the monorepo
|
|
- **.npmrc**: Configures pnpm behavior
|
|
- **Root package.json**: Contains shared scripts and dependencies
|
|
|
|
## CI/CD
|
|
|
|
CI/CD workflows have been updated to use pnpm instead of npm. Make sure your CI environments use pnpm 10.8.1 or higher.
|
|
|
|
## Known issues
|
|
|
|
If you encounter issues with pnpm, try the following solutions:
|
|
|
|
1. Remove the `node_modules` folder and `pnpm-lock.yaml` file, then run `pnpm install`
|
|
2. Make sure you're using pnpm 10.8.1 or higher
|
|
3. Verify that Node.js 22 or higher is installed
|