codex

Generate code via Codex CLI with HtmlGraph event tracking and Claude fallback.

3|3|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/Shakes-tzd/htmlgraph --skill codex-shakes-tzd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex
Source: https://github.com/Shakes-tzd/htmlgraph/tree/main/packages/claude-plugin/skills/codex
Command: npx skills add https://github.com/Shakes-tzd/htmlgraph --skill codex-shakes-tzd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CodexSpawner provides a structured, observable way to generate code via OpenAI Codex with full HtmlGraph event tracking, enabling reproducible, auditable code generation.

Core Features & Use Cases

  • CodexSpawner manages direct Codex CLI invocations with parent context and subprocess tracking.
  • Task fallback to Claude sub-agent for reliable code generation when Codex CLI isn't available.
  • Full observability across HtmlGraph workflows, enabling traceable code generation tasks.

Quick Start

Install the Codex CLI and configure HtmlGraph, then invoke the Skill with a code-generation prompt. If the Codex CLI is not available, fallback to Task(subagent_type=general-purpose) for Claude-based generation. Example: Skill(skill=".claude-plugin:codex", args="Generate API endpoint for user authentication with tests")

Frequently Asked Questions about codex

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

FAQPage Schema
How do I track subprocess execution during automated code generation?

Subprocess tracking during code generation is handled by CodexSpawner, which manages direct Codex CLI invocations with parent context linking and full event tracking for reproducible, auditable outputs.

What is the best way to generate API endpoints with full observability?

Generating API endpoints with full observability uses CodexSpawner to execute Codex CLI tasks while linking parent events and subprocess tracking directly into HtmlGraph workflows for traceable results.

Does this code generation approach work if the Codex CLI is unavailable?

If the Codex CLI is unavailable, the code generation task automatically falls back to using a Claude general-purpose sub-agent, ensuring reliable code generation without interrupting the workflow.

How do I link parent events in HtmlGraph for automated codegen tasks?

Linking parent events in HtmlGraph for codegen tasks is achieved by invoking the Skill with a generation prompt, which uses CodexSpawner to attach parent context and subprocess tracking to each event.

Can I use a Claude fallback for generating middleware and tooling integrations?

Yes, generating middleware and tooling integrations can use the Claude sub-agent fallback via Task(subagent_type=general-purpose) when the primary Codex CLI execution path is not available.

Why do I need HtmlGraph SDK integration for AI code generation?

HtmlGraph SDK integration is needed for AI code generation to provide full observability across workflows, enabling structured, reproducible, and auditable tracking of every code generation event.