codex-linux 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls:*)",
+      "Bash(shellcheck:*)",
+      "Bash(node:*)",
+      "Bash(bash:*)"
+    ]
+  }
+}

package/.eslintrc.json

@@ -0,0 +1,27 @@
+{
+  "root": true,
+  "env": { 
+    "browser": true, 
+    "es2022": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react-hooks/recommended"
+  ],
+  "ignorePatterns": ["dist", ".eslintrc.cjs"],
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["react-refresh"],
+  "rules": {
+    "react-refresh/only-export-components": [
+      "warn",
+      { "allowConstantExport": true }
+    ],
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-unused-vars": ["warn", { 
+      "argsIgnorePattern": "^_",
+      "varsIgnorePattern": "^_"
+    }]
+  }
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,156 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+    tags: ['v*']
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Run unit tests
+        run: npm test -- --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build application
+        run: npm run build
+
+      - name: Package for Linux
+        run: npm run package:linux
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: linux-packages
+          path: |
+            release/*.AppImage
+            release/*.deb
+            release/*.rpm
+
+  release:
+    runs-on: ubuntu-latest
+    needs: [test, build]
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v3
+        with:
+          name: linux-packages
+          path: release/
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            release/*.AppImage
+            release/*.deb
+            release/*.rpm
+            release/*.tar.gz
+          draft: false
+          prerelease: ${{ contains(github.ref, 'beta') || contains(github.ref, 'alpha') }}
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  npm-publish:
+    runs-on: ubuntu-latest
+    needs: [test, build]
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Update package version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          cd packages/npm-installer
+          npm version $VERSION --no-git-tag-version
+
+      - name: Publish to NPM
+        run: |
+          cd packages/npm-installer
+          npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  docker:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: |
+            codexlinux/app:latest
+            codexlinux/app:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

package/.huskyrc

@@ -0,0 +1,7 @@
+{
+  "hooks": {
+    "pre-commit": "lint-staged",
+    "commit-msg": "commitlint -E HUSKY_GIT_PARAMS",
+    "pre-push": "npm run test:ci"
+  }
+}

package/.lintstagedrc

@@ -0,0 +1,13 @@
+{
+  "*.{ts,tsx}": [
+    "eslint --fix",
+    "prettier --write"
+  ],
+  "*.{js,jsx}": [
+    "eslint --fix",
+    "prettier --write"
+  ],
+  "*.{json,md}": [
+    "prettier --write"
+  ]
+}

package/.prettierrc

@@ -0,0 +1,12 @@
+{
+  "bracketSpacing": true,
+  "endOfLine": "lf",
+  "printWidth": 100,
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "useTabs": false,
+  "arrowParens": "avoid",
+  "quoteProps": "as-needed"
+}

package/CLAUDE.md

@@ -0,0 +1,163 @@
+# CLAUDE.md - Codex Linux Configuration
+
+## Project
+
+**Name:** Codex Linux  
+**Description:** A powerful Linux port of OpenAI Codex - command center for managing multiple AI coding agents in parallel  
+**Language:** TypeScript  
+**Framework:** Electron + React
+
+## Coding Standards
+
+**Style:** Follow TypeScript strict mode with explicit types  
+**Linter:** ESLint with TypeScript parser  
+**Formatter:** Prettier with 2-space indentation  
+**Max Line Length:** 100  
+**Indent Size:** 2  
+**Use Tabs:** false
+
+## Architecture
+
+### Patterns
+- Event-driven architecture with EventEmitter
+- Manager pattern for core functionality
+- Repository pattern for database operations
+- Component-based UI architecture
+- Provider pattern for AI services
+
+### Conventions
+- Use async/await for asynchronous operations
+- Prefer dependency injection over singletons
+- Implement proper error handling with try/catch
+- Use meaningful variable names (no single letter except loops)
+- Always clean up resources (intervals, listeners, files)
+
+### Design Principles
+- Single Responsibility Principle
+- Don't Repeat Yourself (DRY)
+- Keep It Simple, Stupid (KISS)
+- Fail fast with clear error messages
+- Security by default
+
+## Libraries
+
+### Preferred
+- electron-log for logging
+- better-sqlite3 for database
+- simple-git for Git operations
+- uuid for unique IDs
+- node-cron for scheduling
+- zod for validation
+
+### Testing
+- Jest for unit tests
+- Playwright for E2E tests
+- @testing-library/react for component tests
+
+### Utilities
+- lodash for utilities
+- date-fns for date manipulation
+- node-fetch for HTTP requests
+
+### Avoid
+- Avoid using any type - always define types
+- Avoid callbacks - use promises/async-await
+- Avoid mutating state directly in React
+- Avoid hardcoded values - use constants
+
+## Review Checklist
+
+### Required
+- [ ] All TypeScript types are defined
+- [ ] Error handling is implemented
+- [ ] No console.log - use electron-log
+- [ ] Security best practices followed
+- [ ] Database migrations included if needed
+
+### Security
+- [ ] No hardcoded secrets or API keys
+- [ ] Input validation implemented
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS prevention in rendered content
+- [ ] File path validation before operations
+
+### Performance
+- [ ] Database queries are optimized
+- [ ] No memory leaks (cleanup intervals/listeners)
+- [ ] Lazy loading for heavy components
+- [ ] Debouncing for frequent operations
+
+## Tools
+
+**Build:** `npm run build`  
+**Test:** `npm test`  
+**Lint:** `npm run lint`  
+**Typecheck:** `npx tsc --noEmit`
+
+## Custom Prompts
+
+### System Prompt
+You are an expert TypeScript developer working on Codex Linux, an Electron application for managing AI coding agents. Follow the coding standards defined in this project. Always provide type-safe code with proper error handling.
+
+### Before Action
+Check if the operation requires permission based on the current permission mode. Log all actions using electron-log.
+
+### After Action
+Verify the changes compile without TypeScript errors. Run the linter and formatter before marking as complete.
+
+### Commit Message
+Format: `type(scope): description`
+
+Types: feat, fix, docs, style, refactor, test, chore
+
+Example: `feat(agents): add CLAUDE.md support`
+
+### PR Description
+Include:
+- What changed
+- Why it changed
+- Testing performed
+- Breaking changes (if any)
+
+## Agents
+
+**Default Model:** gpt-4o  
+**Default Provider:** openai  
+**Skills:** 
+- code-review
+- refactoring
+- testing
+
+**Permission Mode:** ask
+
+## MCP
+
+### Servers
+
+#### Filesystem
+**Command:** npx -y @modelcontextprotocol/server-filesystem  
+**Environment:** 
+- ALLOWED_DIRS=/home/user/projects
+
+#### Git
+**Command:** npx -y @modelcontextprotocol/server-git  
+**Environment:**
+- REPO_ROOT=/home/user/codex-linux-app
+
+## Hooks
+
+**Pre-Edit:** npm run lint:staged  
+**Post-Edit:** npm run format  
+**Pre-Commit:** npm run typecheck && npm test  
+**Post-Commit:** echo "Changes committed successfully"
+
+## Ignore
+
+- node_modules
+- dist
+- build
+- .git
+- *.log
+- coverage
+- .env
+- .env.local

package/DESIGN_SUPERIOR.md

@@ -0,0 +1,73 @@
+# 🎨 DESIGN MINIMALISTE MODERNE - SURPASSE CLAUDE CODE
+
+## ✨ Ce qui rend le design supérieur :
+
+### 1. **Palette de couleurs épurée**
+- Gris neutres sophistiqués (pas de couleurs criardes)
+- Contraste parfait pour la lisibilité
+- Thème clair et sombre harmonieux
+- Accents subtils et élégants
+
+### 2. **Typographie soignée**
+- Police Inter (moderne et lisible)
+- Espacement des lettres optimisé
+- Hiérarchie visuelle claire
+- Tailles de texte cohérentes
+
+### 3. **Micro-interactions élégantes**
+- Transitions fluides (200ms)
+- Hover effects subtils
+- Animations d'apparition (fadeIn, slideIn)
+- Feedback visuel immédiat
+
+### 4. **Espacement généreux**
+- Plus d'air, moins de fouillis
+- Sections bien délimitées
+- Marges cohérentes
+- Respect du "white space"
+
+### 5. **Composants raffinés**
+- Boutons avec states hover/actif
+- Cards avec ombres subtils
+- Inputs avec focus rings discrets
+- Skeleton loaders élégants
+
+### 6. **Scrollbar minimaliste**
+- Design épuré
+- Apparition au hover
+- Couleurs neutres
+- Pas de distractions
+
+## 🆚 Comparaison avec Claude Code :
+
+| Aspect | Claude Code | Codex Linux (Nouveau) |
+|--------|-------------|----------------------|
+| **Palette** | Basique | ✅ **Neutres sophistiqués** |
+| **Typographie** | Standard | ✅ **Inter optimisée** |
+| **Animations** | Simples | ✅ **Micro-interactions** |
+| **Espacement** | Compact | ✅ **Aéré et respirant** |
+| **Cards** | Plates | ✅ **Élevées avec ombre** |
+| **Focus states** | Basiques | ✅ **Raffinés** |
+| **Scrollbar** | Standard | ✅ **Minimaliste** |
+| **Thèmes** | 2 basiques | ✅ **CSS variables modulaires** |
+| **Loading** | Spinner simple | ✅ **Skeleton élégant** |
+| **Sidebar** | Standard | ✅ **Avec descriptions** |
+
+## 🎯 Points forts du design :
+
+1. **✅ Épuré** - Pas d'éléments superflus
+2. **✅ Moderne** - Tendances 2024
+3. **✅ Professionnel** - Convient aux entreprises
+4. **✅ Accessible** - Contraste et lisibilité
+5. **✅ Réactif** - Animations 60fps
+6. **✅ Cohérent** - Design system complet
+7. **✅ Personnalisable** - Variables CSS faciles
+8. **✅ Élégant** - Raffiné et sobre
+
+## 🚀 Le design est :
+- **Plus beau** que Claude Code
+- **Plus moderne** que la plupart des IDE
+- **Plus professionnel** pour les entreprises
+- **Plus agréable** pour les longues sessions
+
+**Interface PRÊTE et SUPÉRIEURE !** 🎨✨

package/Dockerfile

@@ -0,0 +1,64 @@
+# Multi-stage build for Codex Linux
+
+# Stage 1: Build
+FROM node:20-alpine AS builder
+
+# Install build dependencies
+RUN apk add --no-cache \
+    python3 \
+    make \
+    g++ \
+    git
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+COPY packages/cli/package*.json ./packages/cli/
+
+# Install dependencies
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build application
+RUN npm run build
+
+# Stage 2: Production
+FROM node:20-alpine AS production
+
+# Install runtime dependencies
+RUN apk add --no-cache \
+    git \
+    ca-certificates
+
+# Create non-root user
+RUN addgroup -g 1001 -S codex && \
+    adduser -S codex -u 1001
+
+WORKDIR /app
+
+# Copy built application
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+COPY --from=builder /app/assets ./assets
+
+# Create necessary directories
+RUN mkdir -p /home/codex/.config/codex && \
+    chown -R codex:codex /home/codex && \
+    chown -R codex:codex /app
+
+# Switch to non-root user
+USER codex
+
+# Expose ports
+EXPOSE 3001
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD node -e "require('http').get('http://localhost:3001/api/health', (r) => r.statusCode === 200 ? process.exit(0) : process.exit(1))"
+
+# Start application
+CMD ["node", "dist/main/main.js"]

package/INSTALLATION.md

@@ -0,0 +1,152 @@
+# Installation Guide
+
+## Quick Install (Recommended)
+
+### Option 1: One-line Installer (All Linux Distributions)
+
+```bash
+curl -fsSL https://codex-linux.dev/install.sh | bash
+```
+
+This installs the AppImage to `~/.local/bin/` and creates a desktop entry.
+
+**System-wide install (requires sudo):**
+```bash
+curl -fsSL https://codex-linux.dev/install.sh | sudo bash -s -- --system
+```
+
+**Uninstall:**
+```bash
+~/.local/bin/uninstall-codex-linux.sh
+```
+
+---
+
+### Option 2: NPM (For Node.js Developers)
+
+```bash
+# Install globally
+npm install -g codex-linux
+
+# Launch
+codex-linux
+```
+
+**Run without installing:**
+```bash
+npx codex-linux
+```
+
+**Update:**
+```bash
+npm update -g codex-linux
+```
+
+---
+
+## Manual Installation
+
+### AppImage (Universal)
+
+1. Download the latest AppImage from [Releases](https://github.com/ranker-org/codex-linux-app/releases)
+2. Make it executable: `chmod +x Codex-Linux-*.AppImage`
+3. Run it: `./Codex-Linux-*.AppImage`
+
+### Debian/Ubuntu
+
+```bash
+wget https://github.com/ranker-org/codex-linux-app/releases/latest/download/codex-linux_amd64.deb
+sudo dpkg -i codex-linux_amd64.deb
+sudo apt-get install -f  # Fix any dependency issues
+```
+
+### Fedora/RHEL
+
+```bash
+wget https://github.com/ranker-org/codex-linux-app/releases/latest/download/codex-linux.x86_64.rpm
+sudo rpm -i codex-linux.x86_64.rpm
+```
+
+### Arch Linux
+
+```bash
+wget https://github.com/ranker-org/codex-linux-app/releases/latest/download/codex-linux.pacman
+sudo pacman -U codex-linux.pacman
+```
+
+---
+
+## Post-Installation
+
+1. **Launch Codex Linux**:
+   - From applications menu
+   - Or run `codex-linux` from terminal
+
+2. **Configure AI Provider**:
+   - Open Settings → AI Providers
+   - Add your API key (OpenAI, Anthropic, or use free models)
+
+3. **Create your first agent**:
+   - Click "+ New Agent"
+   - Select a project folder
+   - Choose provider and model
+   - Start coding!
+
+---
+
+## Troubleshooting
+
+### AppImage won't run
+
+If the AppImage doesn't launch, you may need to install FUSE:
+
+**Ubuntu/Debian:**
+```bash
+sudo apt install libfuse2
+```
+
+**Fedora/RHEL:**
+```bash
+sudo dnf install fuse
+```
+
+**Arch:**
+```bash
+sudo pacman -S fuse2
+```
+
+### Permission denied
+
+Make sure the AppImage is executable:
+```bash
+chmod +x Codex-Linux-*.AppImage
+```
+
+### Not in PATH
+
+If `codex-linux` command is not found after installation:
+
+```bash
+# Add to your shell profile
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+---
+
+## Supported Platforms
+
+| Platform | Architecture | Status |
+|----------|-------------|--------|
+| Linux (glibc) | x64 | ✅ Fully supported |
+| Linux (glibc) | arm64 | ✅ Fully supported |
+| Linux (musl) | x64 | ⚠️ May require FUSE |
+
+---
+
+## Auto-Updates
+
+Codex Linux includes automatic update checking. When a new version is available, you'll be notified in the application.
+
+To manually check for updates:
+- Go to Settings → About → Check for Updates

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codex Linux 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.