Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions codex/Chart.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
apiVersion: v2
appVersion: '0.125.0'
description: OpenAI's lightweight coding agent that runs in your terminal
name: codex
type: application
version: 1.0.1
104 changes: 104 additions & 0 deletions codex/OlaresManifest.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
olaresManifest.version: '0.11.0'
olaresManifest.type: app
metadata:
name: codex
icon: https://app.cdn.olares.com/appstore/codex/icon.png
description: OpenAI's lightweight coding agent that runs in your terminal
appid: codex
title: Codex CLI
version: 1.0.1
categories:
- Developer Tools
- Productivity_v112
- Utilities
entrances:
- name: terminal
host: terminal
port: 80
title: Codex CLI
icon: https://app.cdn.olares.com/appstore/codex/icon.png
openMethod: window
authLevel: internal
spec:
versionName: '0.125.0'
fullDescription: |
**Overview**
Codex CLI is OpenAI's lightweight, open-source coding agent that runs locally in your terminal. It understands your codebase, executes routine tasks through natural language, and helps you ship faster while staying in flow.

**Key Features**
- Terminal-native TUI with streaming tool output, slash commands, interrupt-and-redirect, and rich diff review.
- Real file edits, shell execution, git workflows, and test runs driven by natural language.
- MCP-compatible tool calling and reusable agent instructions via AGENTS.md / `.codex/skills`.
- Works with a ChatGPT Plus / Pro / Business / Edu / Enterprise plan (OAuth) or an OpenAI API key.

**First-time Setup**
Open the `Codex CLI` entrance and run `codex` to launch the OAuth login flow ("Sign in with ChatGPT"), or set `OPENAI_API_KEY` in the app environment variables and restart.

developer: OpenAI
website: https://chatgpt.com/codex
sourceCode: https://github.com/openai/codex
submitter: Olares
locale:
- en-US
- zh-CN
doc: https://github.com/openai/codex/tree/main/docs
license:
- text: Apache-2.0
url: https://github.com/openai/codex/blob/main/LICENSE
requiredMemory: 1Gi
limitedMemory: 17Gi
requiredDisk: 1Gi
limitedDisk: 50Gi
requiredCpu: 500m
limitedCpu: 5
supportArch:
- amd64
- arm64
permission:
appData: true
appCache: true
userData:
- Home
options:
allowMultipleInstall: true
apiTimeout: 0
dependencies:
- name: olares
type: system
version: '>=1.12.5-0'
envs:
- envName: OPENAI_API_KEY
type: password
required: false
applyOnChange: true
editable: true
default: ""
description: "OpenAI API key (leave empty to use interactive 'Sign in with ChatGPT' OAuth login)"
- envName: OPENAI_BASE_URL
type: url
required: false
applyOnChange: true
editable: true
default: ""
description: "Custom OpenAI-compatible API endpoint (optional, for proxies or self-hosted gateways)"
- envName: CODEX_MODEL
type: string
required: false
applyOnChange: true
editable: true
default: ""
description: "Override the default model (e.g. gpt-5-codex). Leave empty to use the Codex default."
- envName: ALLOW_HOME_DIR_ACCESS
type: bool
required: false
applyOnChange: true
editable: true
default: "false"
description: "Allow Codex CLI to read/write the Olares Home directory"
- envName: ALLOW_EXTERNAL_DIR_ACCESS
type: bool
required: false
applyOnChange: true
editable: true
default: "false"
description: "Allow Codex CLI to read/write the Olares External directory"
54 changes: 54 additions & 0 deletions codex/docker/Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# Codex CLI base image for Olares.
#
# Scope: a thin Ubuntu 24.04 base with the minimum toolbox a Codex CLI
# terminal user expects (curl / git / less / procps / vim / jq), plus a
# non-root user (UID 1000) so the runtime Pod never needs root.
#
# The codex binary itself is NOT baked into this image. It is installed
# at runtime by the init-install-codex initContainer into the shared
# /opt/data PVC (under ~/.local/bin/codex). That keeps base-image size
# small and lets us bump codex versions without rebuilding the image.
#
# Build & push:
# docker buildx build \
# --platform linux/amd64,linux/arm64 \
# -t beclab/harveyff-codex-base:0.1.0 \
# --push .
FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive \
LANG=C.UTF-8 \
LC_ALL=C.UTF-8

# Core toolbox expected by a Codex CLI terminal user. ripgrep is NOT
# installed here: the codex binary ships its own bundled search and
# installing the system one alongside can confuse its file search.
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
ca-certificates \
curl \
git \
jq \
less \
locales \
procps \
tzdata \
unzip \
vim-tiny \
xz-utils \
&& rm -rf /var/lib/apt/lists/* \
&& locale-gen C.UTF-8 \
&& (userdel -r ubuntu 2>/dev/null || true) \
&& (groupdel ubuntu 2>/dev/null || true) \
&& useradd --create-home --uid 1000 --shell /bin/bash codex \
&& mkdir -p /opt/data \
&& chown -R 1000:1000 /opt/data

USER 1000:1000
WORKDIR /opt/data

ENV HOME=/opt/data \
PATH=/opt/data/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
TERM=xterm-256color

CMD ["bash"]
43 changes: 43 additions & 0 deletions codex/docker/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# codex base image

A thin Ubuntu 24.04 base image for the Olares `codex` app.

## What it ships

- `ca-certificates`, `curl`, `git`, `jq`, `less`, `procps`, `tzdata`,
`unzip`, `vim-tiny`, `xz-utils`, `locales` (C.UTF-8 pre-generated).
- A non-root user `codex` (UID 1000) with `HOME=/opt/data` and
`PATH` prepending `/opt/data/.local/bin`.
- No `codex` binary. The binary is installed at runtime by the
`init-install-codex` initContainer into the shared PVC so bumping
codex versions does not require rebuilding this image.

## Build & push

```bash
# Single-arch (local dev)
docker build -t beclab/harveyff-codex-base:0.1.0 .

# Multi-arch release (recommended, matches chart supportArch)
docker buildx create --use --name codex-builder || true
docker buildx build \
--platform linux/amd64,linux/arm64 \
-t beclab/harveyff-codex-base:0.1.0 \
--push .
```

## Bumping the image

When bumping apt dependencies or base Ubuntu:

1. Increment the tag: `0.1.0 -> 0.1.1` (or major if breaking).
2. Update both references in
`codex/templates/deployment.yaml` (initContainer + main container).
3. Bump `version` in `codex/Chart.yaml`.

The `codex` binary itself (rust-v0.125.0 etc.) is controlled separately
by `appVersion` in `Chart.yaml` and `metadata.version` /
`spec.versionName` in `OlaresManifest.yaml`; it is pulled fresh from
the matching GitHub Release tarball whenever
`$HOME/.install-state/codex-<version>` is missing, regardless of base
image tag.
16 changes: 16 additions & 0 deletions codex/i18n/en-US/OlaresManifest.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
metadata:
title: Codex CLI
description: OpenAI's lightweight coding agent that runs in your terminal
spec:
fullDescription: |
**Overview**
Codex CLI is OpenAI's lightweight, open-source coding agent that runs locally in your terminal. It understands your codebase, executes routine tasks through natural language, and helps you ship faster while staying in flow.

**Key Features**
- Terminal-native TUI with streaming tool output, slash commands, interrupt-and-redirect, and rich diff review.
- Real file edits, shell execution, git workflows, and test runs driven by natural language.
- MCP-compatible tool calling and reusable agent instructions via AGENTS.md / `.codex/skills`.
- Works with a ChatGPT Plus / Pro / Business / Edu / Enterprise plan (OAuth) or an OpenAI API key.

**First-time Setup**
Open the `Codex CLI` entrance and run `codex` to launch the OAuth login flow ("Sign in with ChatGPT"), or set `OPENAI_API_KEY` in the app environment variables and restart.
16 changes: 16 additions & 0 deletions codex/i18n/zh-CN/OlaresManifest.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
metadata:
title: Codex CLI
description: OpenAI 官方原版的终端 AI 编码助手
spec:
fullDescription: |
**概述**
Codex CLI 是 OpenAI 官方推出的开源终端智能编码助手。它能够理解你的代码库,通过自然语言执行日常任务,帮助你更高效地开发和保持专注。

**主要功能**
- 基于终端的原生 TUI,支持工具实时输出流、斜杠命令、中断与重定向、丰富的差异审查体验。
- 可通过自然语言进行真实文件编辑、Shell 执行、Git 工作流和测试操作。
- 兼容 MCP 工具调用,可复用 AGENTS.md / `.codex/skills` 中的智能体指令。
- 支持通过 ChatGPT Plus / Pro / Business / Edu / Enterprise 计划(OAuth 登录)或 OpenAI API 密钥使用。

**首次设置**
打开 `Codex CLI` 入口并运行 `codex`,开启 OAuth 登录流程(“使用 ChatGPT 登录”);也可在应用环境变量中配置 `OPENAI_API_KEY`,然后重启应用。
7 changes: 7 additions & 0 deletions codex/owners
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
owners:
- 'LittleLollipop'
- 'TShentu'
- 'hysyeah'
- 'pengpeng'
- 'harveyff'
- 'lovehunter9'
Loading