Skip to content

Releases: mjmkk/opencodex

v0.1.0 — Initial Release

26 Feb 07:14
@mjmkk mjmkk
v0.1.0
8865b08

Choose a tag to compare

View all tags
v0.1.0 — Initial Release Latest
Latest

OpenCodex v0.1.0

First public release of OpenCodex — an iOS client + local Node.js Worker backend that lets you run Claude / Codex AI from your iPhone.

What's Included

iOS App (Swift / SwiftUI + TCA)

  • Multi-thread chat with real-time SSE streaming
  • Command approval sheet (approve / reject / modify)
  • Split-screen WebSocket terminal with SwiftTerm renderer
  • File browser with tree view, full-text search, and code editing
  • path:line tap-to-open links in AI messages
  • Auto-reconnect on foreground resume

Node.js Worker Backend

  • REST + SSE + WebSocket API
  • PTY-based terminal sessions via node-pty
  • Session persistence with SQLite (better-sqlite3)
  • Optional token authentication

Infrastructure

  • Docker support (make docker-up)
  • GitHub Actions CI (backend tests + iOS build)
  • Codecov coverage reporting

Getting Started

git clone https://github.com/mjmkk/opencodex.git
cp codex-worker-mvp/worker.config.example.json codex-worker-mvp/worker.config.json
# edit worker.config.json — add your API key
make docker-up

Then open CodexWorkerApp/CodexWorkerApp/CodexWorkerApp.xcodeproj in Xcode and run.

Full guide → docs/deployment.md

Requirements

  • macOS + Xcode 16+ (to build the iOS app)
  • Node.js ≥ 22 or Docker (to run the Worker)
  • iPhone / iOS Simulator (iOS 17+)
  • Codex CLI or Claude API access
Assets 2
Loading