codex-parallel-subagents

Run multiple AI agent threads in parallel with bounded concurrency. Use for parallel file processing, multi-package updates, batch codebase operations, or fan-out tasks. Uses the MoonBit Codex SDK for agent orchestration.

$ Installieren

git clone https://github.com/moonbit-community/codex-sdk /tmp/codex-sdk && cp -r /tmp/codex-sdk/skills/codex-parallel-subagents ~/.claude/skills/codex-sdk

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

name: codex-parallel-subagents description: Run multiple AI agent threads in parallel with bounded concurrency. Use for parallel file processing, multi-package updates, batch codebase operations, or fan-out tasks. Uses the MoonBit Codex SDK for agent orchestration.

Codex Parallel Subagents

Run multiple AI agent threads concurrently with bounded parallelism and collect results safely.

When to use this skill

Running multiple agent tasks in parallel
Fan-out work across files, packages, or repositories
Batch processing with rate limiting
Streaming progress from concurrent tasks
Collecting structured outputs from multiple agents

Quick navigation

Need	Resource
New to Codex SDK	references/codex-basics.md
Advanced options	references/codex-advanced.md
Async patterns	references/async-basics.md
Troubleshooting	references/troubleshooting.md

Production-ready assets

Copy these to jumpstart your implementation:

Asset	Description	Run
parallel_batch	Reentrant batch processing with stdin/file input, offset/limit, JSON output	`moon run -C assets/parallel_batch assets/parallel_batch`
package_analyzer	Discover and summarize all MoonBit packages	`moon run -C assets/package_analyzer assets/package_analyzer`

How to use these assets

Copy the asset directory to your project
Customize run_task() (or the main processing function) for your use case
Adjust structs (TaskInput, etc.) if you need additional fields
Set environment variables as needed (CODEX_WORKDIR, PARALLELISM)

See each asset's README for detailed usage and options.

Key rules

One thread per task - never share threads across concurrent tasks
Use semaphores - guard parallel runs with @async.Semaphore::new(n) to avoid rate limits
Set working directory - use ThreadOptions::new(working_directory=...) for task isolation
Allow failures - use allow_failure=true and capture errors per task
Avoid conflicts - for tasks that modify shared resources (e.g., building software, editing same files), use git worktrees or separate directories to isolate each agent