codex-delegate

Delegate background computational and file-editing tasks to the Codex CLI with file-based job tracking.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/kazukitcy/skills --skill codex-delegate-kazukitcy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-delegate
Source: https://github.com/kazukitcy/skills/tree/main/codex-delegate
Command: npx skills add https://github.com/kazukitcy/skills --skill codex-delegate-kazukitcy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, git, codex, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the problem of managing long-running or background tasks for the Codex AI, ensuring that jobs are tracked, verified, and recoverable without manual intervention or context loss.

Core Features & Use Cases

  • Background Orchestration: Safely offload investigation, implementation, or bulk editing tasks to Codex in the background.
  • Durable Protocol: Uses a file-based job directory system to record status, stderr, and results, providing a clear audit trail for every task.
  • Failure Recovery: Includes a robust failure taxonomy and resume scripts to handle stalled jobs, mid-flight crashes, or interrupted processes.

Quick Start

Use the codex-delegate skill to launch a background task by composing a prompt file and executing the backend script with the appropriate sandbox configuration.

Frequently Asked Questions about codex-delegate

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

FAQPage Schema
How do I run background tasks with Codex without losing progress on crashes?▼

To run background tasks without losing progress, this skill uses a durable, file-based protocol to track job status and results. It implements a comprehensive failure taxonomy and resume scripts to automatically recover stalled jobs or interrupted processes during Codex delegation.

Can I delegate bulk file editing and code review to Codex in isolated workspaces?▼

Yes, you can delegate bulk mechanical edits, code reviews, and design spikes to Codex within isolated workspaces. The skill safely offloads these computational and file-editing tasks to the background while maintaining a clear audit trail for every operation.

What's the best way to orchestrate long-running Codex jobs for complex workflows?▼

The best way to orchestrate long-running Codex jobs is by composing a prompt file and executing the backend script with the appropriate sandbox configuration. This approach ensures complex workflows are tracked, verified, and recoverable across intermittent execution environments without manual intervention.

Do I need bash and git to use codex-delegate for background task recovery?▼

Yes, you need bash, git, and the codex CLI installed to use this background task delegation skill. These dependencies are required to execute the backend scripts, manage the file-based job directory system, and handle the state recovery protocol.

How does the failure taxonomy handle stalled jobs during Codex workflow orchestration?▼

The failure taxonomy handles stalled jobs by recording status, stderr, and results in a durable file-based job directory. This allows the system to verify task completion, classify the failure, and execute state recovery scripts to resume interrupted processes.

When should I not use background task delegation for Codex?▼

You should not use background task delegation for Codex if your workflow requires immediate, synchronous feedback or lacks an isolated workspace environment. The skill is designed for long-running, complex background tasks that benefit from durable tracking rather than quick, interactive commands.