# Codex Background

Keep a Codex orchestrator's delegation to an installed delegate skill pending until its...

- Repository: https://github.com/amElnagdy/delegate-skills (2546 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add amElnagdy/delegate-skills --skill codex-background -g -a claude-code -y`
Codex: `npx skills add amElnagdy/delegate-skills --skill codex-background -g -a codex -y`
Cursor: `npx skills add amElnagdy/delegate-skills --skill codex-background -g -a cursor -y`
Gemini CLI: `npx skills add amElnagdy/delegate-skills --skill codex-background -g -a gemini-cli -y`

## Description

Keep a Codex orchestrator's delegation to an installed delegate skill pending until its registered relay completes, without model-driven progress polling. Use with a selected implementer delegate skill when Codex is the orchestrator and the delegation should wait in the background; sets up its MCP server on first use.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Codex background delegation

This support skill changes Codex's waiting boundary. The selected delegate skill still owns the
brief, provider arguments, permissions, result interpretation, review, gates and landing.
Claude's background Bash workflow stays unchanged. The support utility is installed separately,
never implicitly as a dependency of codex-delegate. Details: [references/configuration.md](references/configuration.md).

## First use / setup

If the `delegate_run` tool is not available, setup is incomplete. Tell the user that bootstrap will
update `$CODEX_HOME/config.toml` (default `~/.codex/config.toml`, backed up first) and write a registry of
the installed `*-delegate` skills, then run:

```bash
node "<skill-dir>/scripts/bootstrap.mjs"
```

`<skill-dir>` is this skill's installed directory (the folder containing this `SKILL.md`). It writes
outside the workspace, so request the approval or sandbox escalation Codex needs for that. Report its
output, then ask the user to restart Codex (or reload MCP servers); the tools appear after that.
If bootstrap fails, report the failure. Do not fall back to shell polling. Run it again after
installing more delegate skills. `node "<skill-dir>/scripts/bootstrap.mjs" --check` validates the setup without writing.

## Procedure

The rest: https://github.com/amElnagdy/delegate-skills/blob/HEAD/skills/codex-background/SKILL.md