Getty

Our Codex — Development skill for Claude Code

Development community

From each .claude/, to each AGENTS.md — bridge Claude Code skills/agents to OpenAI Codex.

How to install Our Codex

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Getty/our-codex and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Our Codex does

From each .claude/, to each AGENTS.md — bridge Claude Code skills/agents to OpenAI Codex.

Alternatives in Development

  • OpenAI Codex CLI — (Rust implementation) 67.8k ★
  • Codexbar — Show usage stats for OpenAI Codex and Claude Code, without having to login 8.8k ★
  • Cyberboss — 一个接入微信的本地生活 Agent Bridge,让 Codex / Claude Code 拥有时间感、行踪感、随机唤醒和自主唤醒能力,用主动陪伴替代所有番茄钟和效率工具,自动记录日记、维护生活时间轴、发送文件和表情包 1.3k ★

README

our-codex

*From each `.claude/`, to each `AGENTS.md`.*

Bridge your [Claude Code](https://claude.ai/code) skills and agents to [OpenAI Codex](https://developers.openai.com/codex/cli/). Write your knowledge base once in `.claude/`, use it everywhere.

The Problem

Claude Code stores context in `.claude/skills/` and `.claude/agents/`. Codex reads `AGENTS.md`. If you use both tools, you're maintaining two copies of the same knowledge.

The Solution

`our-codex` reads your `.claude/` hierarchy — skills, agents, `CLAUDE.md` — strips the YAML frontmatter, and assembles everything into a single `AGENTS.md` that Codex understands. Then it launches Codex.

.claude/skills/my-skill/SKILL.md  ──┐
.claude/agents/my-agent.md         ──┼──▶  AGENTS.md  ──▶  codex
CLAUDE.md                          ──┘

Install

git clone https://github.com/Getty/our-codex.git
ln our-codex/our-codex ~/bin/our-codex   # or anywhere in PATH

**Requirements:** Perl 5 (core modules only), `npx`, `@openai/codex`

Usage

our-codex [base-dir] [+skill ...] [-r|--resume] [-- codex-args...]
Argument Description
base-dir How far up to look for .claude/ directories. Default: CWD only. Use .. for parent, ../.. for grandparent.
+skill-name Pull an extra skill by name from anywhere in the hierarchy (including ~/.claude/). Can be repeated.
-r, --resume Resume the last Codex session in this directory. Regenerates AGENTS.md first.
-- args Everything after -- is forwarded to Codex.

Examples

cd ~/projects/my-app

our-codex                           # Only my-app/.claude/ + CLAUDE.md
our-codex ..                        # Include parent .claude/ too
our-codex +github-cli               # CWD + github-cli skill from ~/.claude/
our-codex .. +vast-ai-cli           # Parent chain + extra skill
our-codex -r                        # Resume last session
our-codex -- --full-auto            #