Skip to content

installation.md

Latest commit

 

History

History
141 lines (98 loc) · 2.6 KB

installation.md

File metadata and controls

141 lines (98 loc) · 2.6 KB

Installation

Quick Install

Termux (Android ARM64)

# Update Termux packages and install Node.js
pkg update && pkg upgrade -y
pkg install nodejs-lts -y

# Latest (tracks upstream OpenAI)
npm install -g @mmmbuto/codex-cli-termux

# OR LTS (stable, /chat compatible)
npm install -g @mmmbuto/codex-cli-lts

# Verify
codex --version
codex login

Requirements: Android 7+, ARM64, Node.js >=18 (recommended v22+), ~50MB storage

Linux (x64)

# Install Node.js (example for Debian/Ubuntu)
sudo apt-get update
sudo apt-get install -y nodejs npm

# LTS (Linux support)
npm install -g @mmmbuto/codex-cli-lts

# Verify
codex --version
codex login

Requirements: Linux x64, Node.js >=18 (recommended v22+), ~80MB storage

macOS (arm64)

# Using npm
npm install -g @mmmbuto/codex-cli-lts

# Verify
codex --version
codex login

Requirements: macOS arm64, Node.js >=18 (recommended v22+), ~100MB storage

Package Information

@mmmbuto/codex-cli-termux (Latest)

  • Focus: Termux-only, tracks upstream OpenAI closely
  • Platform: Android Termux (ARM64)
  • Updates: Follows upstream OpenAI releases
  • Use case: Latest features, bleeding-edge updates

@mmmbuto/codex-cli-lts (LTS)

  • Focus: Long-term support, stability, /chat compatibility
  • Base: OpenAI Codex rust-v0.80.0
  • Platform: Linux x64 + Android Termux (ARM64) + macOS arm64
  • Updates: Minimal features + security patches only
  • Use case: Production stability, /chat wire API support

Troubleshooting

Termux Issues

Package manager errors:

pkg update && pkg upgrade -y

Node.js not found:

pkg install nodejs-lts -y

Linux Issues

Permission denied on install:

sudo npm install -g @mmmbuto/codex-cli-lts

macOS Issues

Permission denied on install:

sudo npm install -g @mmmbuto/codex-cli-lts

Binary not found after install:

# Check installation location
which codex

# Manually add to PATH
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Verification

After installation, verify everything works:

# Check version
codex --version

# Check binary
codex-exec --help

# Test login (opens browser)
codex login

Links