skills.rest
yakeworld
yakeworldCOMMUNITY
Explore all skills by this author →
GitHub

codex-install-guide

Installs and configures Codex CLI with opencode coexistence and multi-profile management.

6|1|Updated May 11, 2026
Search Tags:#devops#linux#opencode#codex cli#profile management#npm install#cron troubleshooting
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill codex-install-guide-yakeworld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-install-guide
Source: https://github.com/yakeworld/Synthos/tree/main/skills/private/devops/codex-install-guide
Command: npx skills add https://github.com/yakeworld/Synthos --skill codex-install-guide-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @openai/codex.

What problem does it solve? Installing Codex CLI involves several traps: a removed legacy npm package name, a third-party paid repackager that hijacks your vLLM config, coexistence conflicts with opencode, and silent batch timeouts when cron-referenced profiles are missing. This Skill guides safe installation, coexistence, and profile troubleshooting. ## Core Features & Use Cases - Safe Package Selection: Enforces the official @openai/codex npm package, rejects the removed @openai/codexec name and the paid repackager @codexapi/codexclaude that overwrites ~/.codex/config.toml. - Coexistence with opencode: Uses natural isolation between ~/.codex/config.toml and ~/.local/share/opencode/auth.json so both tools run without interference. - Multi-Profile Management & Timeout Diagnosis: Creates and validates profiles under ~/.codex/profiles/ and diagnoses silent codex exec batch timeouts caused by missing profile files. - Use Case: A cron job referencing profile amax starts timing out with no error message; the Skill checks ls ~/.codex/profiles/, finds amax.config.toml missing, provides the TOML template, and verifies with codex -p amax exec "echo test". ## Quick Start Ask the agent to install Codex CLI on a Linux workstation that already runs opencode and verify that the amax profile used by cron scripts works.

Frequently Asked Questions about codex-install-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Codex CLI with npm?▼

Install Codex CLI with npm i -g @openai/codex, the official package. Then verify with which codex and codex --version to confirm a valid binary path and no errors.

Can Codex CLI and opencode run on the same machine?▼

Yes, Codex CLI and opencode coexist without conflict. Codex uses ~/.codex/config.toml while opencode uses ~/.local/share/opencode/auth.json, and their binary names differ, so neither overwrites the other's configuration.

Why does codex exec time out silently in cron jobs?▼

Silent codex exec batch timeouts usually mean a cron-referenced profile file is missing from ~/.codex/profiles/. Check the directory with ls, create the missing profile TOML file, then verify with codex -p <name> exec "echo test".

Is @codexapi/codexclaude safe to install?▼

No, @codexapi/codexclaude is a third-party paid repackager that overwrites ~/.codex/config.toml and points it to a paid endpoint. It should be refused; only the official @openai/codex package should be installed.

How do I configure multiple Codex CLI profiles?▼

Create one TOML file per profile under ~/.codex/profiles/, defining model, model_provider, and the provider's base_url and env_key. Invoke a profile with codex -p <name> exec "command" and verify each one before referencing it in cron scripts.

Related Skills

Explore More Software Engineering Skills→
thinking-machines-labthinking-machines-lab
4.0k

setup

Guide Tinker installation, environment setup, API key provisioning, and verification.

Official
Intermediate
JuanMS20JuanMS20

automation

Orchestrate multi-step workflows with cron scheduling, subtask delegation, and logging.

Community
Intermediate
jacob-balslevjacob-balslev
1

cron-scheduling

Design cron job architectures with idempotency, overlap prevention, and monitoring.

Community
Intermediate
ripgraphicsripgraphics

oracle

Analyze complex bugs, security vulnerabilities, and architecture with GPT-5.

Community
Advanced