Codex Background
Keep a Codex orchestrator's delegation to an installed delegate skill pending until its...
Install
npx skills add amElnagdy/delegate-skills --skill codex-background -g -a claude-code -y- Repository
- amElnagdy/delegate-skills2.5k
- Category
- AI and agents
- Updated
- 6d ago
- License
- MIT
- Context cost
- Lightabout 878 tokens
- Runs scripts
- Yes, review before use
What it does
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.
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.
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:
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.
