Skip to content
TakoAPI
Back to skills

codex-orchestrator

by microcarft

Coding Agents & IDEs
2.5kDownloads reported by clawskills.sh
1Stars
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Monitor, control, and orchestrate background Codex sessions.

Description

What This Skill Does

Workflow for supervising OpenAI Codex coding agent sessions running in background PTY processes. Covers launching sessions, monitoring log output, intervening at stuck prompts, and resuming killed sessions.

Lets you run Codex tasks fully asynchronously and intervene programmatically without keeping an interactive terminal session open.

When to Use It

  • Running a large refactor job in the background while continuing other work
  • Detecting when Codex is waiting for an interactive prompt mid-task
  • Sending approval input to a blocked Codex session without reopening a terminal
  • Recovering a Codex session after a crash or manual kill
  • Tracking multiple parallel Codex tasks by session ID

Example Workflow

INPUT

User asks: Run a full-auto Codex session to add input validation to the checkout module

AGENT
  1. 1

    Launch Codex in a background PTY session with the prompt and store the returned sessionId

  2. 2

    Poll logs every few minutes using process action:log to check for progress or blockage

  3. 3

    Detect an interactive approval prompt in the log output

  4. 4

    Send 'y' via process action:submit to unblock the session

  5. 5

    Wait for task completion, then summarize changed files and notify the user

OUTPUT

Checkout module updated with input validation, Codex session completed without manual terminal intervention

Requirements

  • OpenAI API key (required by Codex CLI)

Installation

clawhub install microcarft/codex-orchestrator

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links