Lightweight coding agent that runs in your terminal
$ npx -y skills add openai/codex --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: openai/codex
What's inside
Run the following on Mac or Linux to install Codex CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Run the following on Windows to install Codex CLI:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
The standalone installers download from https://releases.openai.com/codex by default and fall back to GitHub Releases if a metadata or asset download is unavailable. To force GitHub Releases, set CODEX_INSTALLER_USE_RELEASES_OPENAI_COM to false (0 and no are also accepted):
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex
Codex CLI can also be installed via the following package managers:
# Install using npm
npm install -g @openai/codex
# Install using Homebrew
brew install --cask codex
Then simply run codex to get started.
Each GitHub Release contains many executables, but in practice, you likely want one of these:
codex-aarch64-apple-darwin.tar.gzcodex-x86_64-apple-darwin.tar.gzcodex-x86_64-unknown-linux-musl.tar.gzcodex-aarch64-unknown-linux-musl.tar.gzEach archive contains a single entry with the platform baked into the name (e.g., codex-x86_64-unknown-linux-musl), so you likely want to rename it to codex after extracting it.
Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Business, Edu, or Enterprise plan. Learn more about what's included in your ChatGPT plan.
You can also use Codex with an API key, but this requires additional setup.
This repository is licensed under the Apache-2.0 License.
.bazelignore
.bazelrc
.bazelversion
.codespellignore
.codespellrc
.codex/
environments/
environment.toml
skills/
babysit-pr/
agents/
openai.yaml
references/
github-api-notes.md
heuristics.md
scripts/
gh_pr_watch.py
test_gh_pr_watch.py
SKILL.md
code-review/
code-review-breaking-changes/
SKILL.md
code-review-change-size/
SKILL.md
code-review-context/
SKILL.md
code-review-testing/
SKILL.md
SKILL.md
codex-bug/
SKILL.md
codex-issue-digest/
agents/
openai.yaml
scripts/
collect_issue_digest.py
test_collect_issue_digest.py
SKILL.md
codex-pr-body/
SKILL.md
path-types/
SKILL.md
pushing-ci-changes/
SKILL.md
remote-tests/
SKILL.md
test-tui/
SKILL.md
update-v8-version/
agents/
openai.yaml
SKILL.md
.devcontainer/
codex-install/
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
devcontainer.json
devcontainer.secure.json
Dockerfile
Dockerfile.secure
init-firewall.sh
post_install.py
post-start.sh
README.md
.gitattributes
.github/
actions/
check-clean-worktree/
action.yml
linux-code-sign/
action.yml
prepare-bazel-ci/
action.yml
run-argument-comment-lint/
action.yml
setup-akv-pkcs11-codesigning/
action.yaml
setup-bazel-ci/
action.yml
setup-ci/
action.yml
setup-msvc-env/
action.yml
setup-msvc-env.ps1
setup-rusty-v8/
action.yml
windows-code-sign/
action.yml
blob-size-allowlist.txt
CODEOWNERS
codex/
codex-cli-splash.png
home/
config.toml
labels/
codex-attempt.md
codex-review.md
codex-rust-review.md
codex-triage.md
dependabot.yaml
dotslash-argument-comment-lint-config.json
dotslash-config.json
dotslash-zsh-config.json
ISSUE_TEMPLATE/
1-codex-app.yml
2-extension.yml
3-cli.yml
4-bug-report.yml
5-feature-request.yml
6-docs-issue.yml
pull_request_template.md
scripts/
archive-release-symbols-and-strip-binaries.sh
build-codex-package-archive.sh
build-zsh-release-artifact.sh
check_ci_results.py
compute-bazel-windows-path.ps1
install-musl-build-tools.sh
macos-signing/
codex-app-server.entitlements.plist
codex-code-mode-host.entitlements.plist
codex-responses-api-proxy.entitlements.plist
codex.entitlements.plist
notarize_macos_binary_with_akv.sh
notarize_macos_dmg_with_akv.sh
notarize_with_akv.py
sign_macos_code.sh
test_notarize_with_akv.py
publish_r2_release.py
run_bazel_with_buildbuddy.py
run-argument-comment-lint-bazel.sh
run-bazel-ci.sh
run-bazel-query-ci.sh
rusty_v8_bazel.py
rusty_v8_module_bazel.py
setup-dev-drive.ps1
test_macos_signing_entitlements.py
test_run_bazel_with_buildbuddy.py
test_rusty_v8_bazel.py
test_v8_canary_changes.py
v8_canary_changes.py
verify_bazel_clippy_lints.py
verify_cargo_workspace_manifests.py
verify_tui_core_boundary.py
workflows/
bazel.yml
blob-size-policy.yml
blocking-ci.yml
cargo-deny.yml
cla.yml
close-stale-contributor-prs.yml
codespell.yml
Dockerfile.bazel
issue-deduplicator.yml
issue-labeler.yml
issue-translator.yml
postmerge-ci.yml
python-runtime-build.yml
python-runtime-release.yml
python-sdk-release.yml
r2-release.yml
README.md
repo-checks.yml
rust-ci-full-nextest-platform.yml
rust-ci-full.yml
rust-ci.yml
rust-release-argument-comment-lint.yml
rust-release-prepare.yml
rust-release-windows.yml
rust-release-zsh.yml
rust-release.yml
rusty-v8-release.yml
sdk.yml
v8-canary.yml
zstd
.gitignore
.markdownlint-cli2.yaml
.npmrc
.prettierignore
.prettierrc.toml
.vscode/
extensions.json
launch.json
settings.json
.worktreeinclude
AGENTS.md
announcement_tip.toml
bazel/
modules/
BUILD.bazel
wine.MODULE.bazel
platforms/
BUILD.bazel
release_binaries.bzl
rules/
BUILD.bazel
e2e_benchmark.bzl
testing/
BUILD.bazel
foreign_platform_binary.bzl
wine/
BUILD.bazel
fixtures/
windows_smoke.rs
src/
lib_tests.rs
lib.rs
wine_runtime.bzl
wine.bzl
toolchains/
prost/
BUILD.bazel
BUILD.bazel
CHANGELOG.md
codex-cli/
.gitignore
bin/
codex.js
package.json
scripts/
build_npm_package.py
init_firewall.sh
README.md
run_in_container.sh
codex-rs/
.cargo/
audit.toml
config.toml
.config/
nextest.toml
.gitignore
agent-graph-store/
BUILD.bazel
Cargo.toml
src/
error.rs
lib.rs
local.rs
store.rs
types.rs
agent-identity/
BUILD.bazel
Cargo.toml
src/
lib.rs
analytics/
BUILD.bazel
Cargo.toml
src/
accepted_lines.rs
analytics_capture.rs
analytics_client_tests.rs
client_tests.rs
client.rs
events.rs
facts.rs
lib.rs
reducer.rs
ansi-escape/
BUILD.bazel
Cargo.toml
README.md
src/
lib.rs
app-server/
app-server-client/
BUILD.bazel
Cargo.toml
README.md
src/
lib.rs
path.rs
remote.rs
app-server-daemon/
BUILD.bazel
Cargo.toml
README.md
src/
backend/
mod.rs
pid_tests.rs
pid.rs
client.rs
lib.rs
managed_install_tests.rs
managed_install.rs
remote_control_client.rs
settings.rs
update_loop_tests.rs
update_loop.rs
app-server-protocol/
app-server-protocol-noop-macros/
BUILD.bazel
Cargo.toml
src/
lib.rs
BUILD.bazel
Cargo.toml
schema/
json/
ApplyPatchApprovalParams.json
ApplyPatchApprovalResponse.json
AttestationGenerateParams.json
AttestationGenerateResponse.json
ChatgptAuthTokensRefreshParams.json
ChatgptAuthTokensRefreshResponse.json
ClientNotification.json
ClientRequest.json
codex_app_server_protocol.schemas.json
codex_app_server_protocol.v2.schemas.json
CommandExecutionRequestApprovalParams.json
CommandExecutionRequestApprovalResponse.json
DynamicToolCallParams.json
DynamicToolCallResponse.json
ExecCommandApprovalParams.json
ExecCommandApprovalResponse.json
FileChangeRequestApprovalParams.json
FileChangeRequestApprovalResponse.json
FuzzyFileSearchParams.json
FuzzyFileSearchResponse.json
FuzzyFileSearchSessionCompletedNotification.json
FuzzyFileSearchSessionUpdatedNotification.json
JSONRPCError.json
JSONRPCErrorError.json
JSONRPCMessage.json
JSONRPCNotification.json
JSONRPCRequest.json
JSONRPCResponse.json
McpServerElicitationRequestParams.json
McpServerElicitationRequestResponse.json
PermissionsRequestApprovalParams.json
PermissionsRequestApprovalResponse.json
RequestId.json
ServerNotification.json
ServerRequest.json
ToolRequestUserInputParams.json
ToolRequestUserInputResponse.json
v1/
InitializeParams.json
InitializeResponse.json
v2/
AccountLoginCompletedNotification.json
AccountRateLimitsUpdatedNotification.json
AccountUpdatedNotification.json
AgentMessageDeltaNotification.json
AppListUpdatedNotification.json
AppsInstalledParams.json
AppsInstalledResponse.json
AppsListParams.json
AppsListResponse.json
AppsReadParams.json
AppsReadResponse.json
CancelLoginAccountParams.json
CancelLoginAccountResponse.json
CommandExecOutputDeltaNotification.json
CommandExecParams.json
CommandExecResizeParams.json
CommandExecResizeResponse.json
CommandExecResponse.json
CommandExecTerminateParams.json
CommandExecTerminateResponse.json
CommandExecutionOutputDeltaNotification.json
CommandExecWriteParams.json
CommandExecWriteResponse.json
ConfigBatchWriteParams.json
ConfigReadParams.json
ConfigReadResponse.json
ConfigRequirementsReadResponse.json
ConfigValueWriteParams.json
ConfigWarningNotification.json
ConfigWriteResponse.json
ConsumeAccountRateLimitResetCreditParams.json
ConsumeAccountRateLimitResetCreditResponse.json
ContextCompactedNotification.json
DeprecationNoticeNotification.json
EnvironmentConnectionNotification.json
ErrorNotification.json
ExperimentalFeatureEnablementSetParams.json
ExperimentalFeatureEnablementSetResponse.json
ExperimentalFeatureListParams.json
ExperimentalFeatureListResponse.json
ExternalAgentConfigDetectParams.json
ExternalAgentConfigDetectResponse.json
ExternalAgentConfigImportCompletedNotification.json
ExternalAgentConfigImportHistoriesReadResponse.json
ExternalAgentConfigImportHistoryRecordParams.json
ExternalAgentConfigImportHistoryRecordResponse.json
ExternalAgentConfigImportParams.json
ExternalAgentConfigImportProgressNotification.json
ExternalAgentConfigImportResponse.json
FeedbackUploadParams.json
FeedbackUploadResponse.json
FileChangeOutputDeltaNotification.json
FileChangePatchUpdatedNotification.json
FsChangedNotification.json
FsCopyParams.json
FsCopyResponse.json
FsCreateDirectoryParams.json
FsCreateDirectoryResponse.json
... 1600 moreShowing a partial view of a very large repo.
FAQ
codex is a Claude Code plugin with 6 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes imagegen, openai-docs, plugin-creator. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.