Agent skill

Codex Agent

by dztabel-happy in dztabel-happy/codex-agent

用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。

No licenceAuto-check passed

Install Codex Agent

skills CLI
$ npx skills add dztabel-happy/codex-agent --skill codex-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dztabel-happy/codex-agent codex-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codex-agent
GitHub stars
157
Token cost
~936 tokens
SKILL.md length
258 words
Files
33 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。

  • Works in 6 steps: 长任务 / 需要人工可接管 / 可能遇到审批 → 一次性自动执行 / CI 风格任务 → 明确是代码审查 → …
  • SKILL.md covers 当前事实, 设计边界, 入口选择 and 启动后的状态管理, plus 8 more sections
  • Runs Shell and Python scripts from its folder; calls bash and codex

What it does

Codex Agent is an agent skill from dztabel-happy/codex-agent. 用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 34 other files, including reference files (for example `CHANGELOG.md`, `INSTALL.md` and `README.md`).

It works with tmux.

Example prompts

  • “/codex-agent”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 长任务 / 需要人工可接管 / 可能遇到审批
  2. 一次性自动执行 / CI 风格任务
  3. 明确是代码审查
  4. Codex 更新提示
  5. 目录 trust 提示
  6. 审批提示

What it can do on your machine

Read from SKILL.md and the folder at commit 191ebaa. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell and Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex Agent loads about 936 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 258 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~936
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 258 words (~936 tokens).

“你是 OpenClaw 内部负责操作 Codex CLI 的执行器。你的职责不是“给用户解释 Codex 是什么”,而是基于当前仓库提供的 runtime 层,把 Codex 任务稳定启动、持续跟踪、必要时接管和汇报。”

— opening of SKILL.md by dztabel-happy
name
codex-agent

Read the full SKILL.md on GitHub

Files

SKILL.md and 32 other files (references) in the repository root of dztabel-happy/codex-agent.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • INSTALL.md
  • README.md
  • README_EN.md
  • hooks/hook_common.sh
  • hooks/on_complete.py
  • hooks/pane_monitor.sh
  • hooks/pane_state.sh
  • hooks/run_codex.sh
  • hooks/start_codex.sh
  • hooks/stop_codex.sh
  • knowledge/UPDATE_PROTOCOL.md
  • knowledge/capabilities.md
  • knowledge/changelog.md
  • knowledge/config_schema.md
  • knowledge/features.md
  • knowledge/prompting_patterns.md
  • … and 14 more

Open the folder on GitHubat commit 191ebaa

Compare with similar skills

Codex Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Agent this skilldztabel-happy/codex-agent157—~936Automated safety check: PassNone
Codex Plugin QAcode-yeongyu/oh-my-openagent70k1 repos~1.9kAutomated safety check: PassCustom licence
Tmuxopenclaw/openclaw392k2 repos~640Automated safety check: PassMIT
1passwordtrpc-group/trpc-agent-go1.8k15 repos~656Automated safety check: PassApache-2.0
CodeGraph Agent Evalcolbymchenry/codegraph73k—~950Automated safety check: PassMIT
Tmuxtrpc-group/trpc-agent-go1.8k24 repos~868Automated safety check: PassApache-2.0

Similar skills

  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub starsUsed in 1 repo~1.9k tokens
    Testing & QAAuto-check passed
  • Tmux

    openclaw/openclaw

    Control tmux sessions/panes for interactive CLIs: list, capture output, send keys, paste text, monitor prompts.

    392k GitHub starsUsed in 2 repos~640 tokens
    Auto-check passed
  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 15 repos~656 tokens
    AI & LLM EngineeringAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    73k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Tmux

    trpc-group/trpc-agent-go

    Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

    1.8k GitHub starsUsed in 24 repos~868 tokens
    Data & AnalyticsAuto-check passed
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

Works with

Questions about Codex Agent

What does Codex Agent do?

用 OpenClaw 驱动 Codex CLI 的受管运行时。支持交互式 tmux 会话、一次性 exec 任务、会话状态查询、显式 session-id 路由、启动阻塞识别与完成通知。. Codex Agent is an agent skill from dztabel-happy/codex-agent.

How do I install Codex Agent in Claude Code?

Run `npx skills add dztabel-happy/codex-agent --skill codex-agent -a claude-code`. Or copy the skill folder (the dztabel-happy/codex-agent repository) into .claude/skills/codex-agent in your project. Claude Code loads it when a task matches its description.

How do I install Codex Agent in Codex?

Run `npx skills add dztabel-happy/codex-agent --skill codex-agent -a codex`. Or copy the skill folder (the dztabel-happy/codex-agent repository) into .agents/skills/codex-agent in your project. Codex loads it when a task matches its description.

Can I use Codex Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dztabel-happy/codex-agent --skill codex-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-agent, .gemini/skills/codex-agent, .github/skills/codex-agent and .opencode/skills/codex-agent in your project.

What does Codex Agent need to run?

Going by SKILL.md and its folder, Codex Agent needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (bash and codex). Our summary lists: Python 3; A Bash shell.

Does Codex Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Codex Agent use?

No licence was found for Codex Agent or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Codex Agent use?

About 936 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 811 tokens, read only when the agent opens those files.

What are the alternatives to Codex Agent?

Skills that share tags, products or a category with Codex Agent: Codex Plugin QA (code-yeongyu/oh-my-openagent, 70k stars), Tmux (openclaw/openclaw, 392k stars), 1password (trpc-group/trpc-agent-go, 1.8k stars) and CodeGraph Agent Eval (colbymchenry/codegraph, 73k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Agent?

dztabel-happy (a GitHub user) maintains it in dztabel-happy/codex-agent, which has 157 GitHub stars. The repository was last updated on March 24, 2026.

Source: dztabel-happy/codex-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.