remote-codex-test-flow

Validate S3-only remote Codex worker queues and job processing workflows.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill remote-codex-test-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remote-codex-test-flow
Source: https://github.com/Pear-Commerce/pear-ai-skills/tree/main/skills/remote-codex-test-flow
Command: npx skills add https://github.com/Pear-Commerce/pear-ai-skills --skill remote-codex-test-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aws-cli, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of verifying remote Codex worker S3 queue behavior, job submission, status tracking, and result retrieval, removing guesswork when debugging or validating remote worker systems.

Core Features & Use Cases

  • End-to-End Probe Testing: Submit test jobs to active remote Codex workers and validate that they process tasks correctly and return properly formatted result envelopes.
  • Protocol Smoke Testing: Validate S3 path structure, conditional writes, and status polling logic even when no workers are active, without requiring a full worker execution.
  • Worker and Job Inspection: View active worker host heartbeats, tail job execution logs, and check real-time job status to diagnose queue or processing issues. Use Case: For example, if you have just deployed a new remote Codex worker pool, use this Skill to submit probe jobs, confirm workers claim and process tasks as expected, and verify all result data matches your required schema.

Quick Start

Use the remote-codex-test-flow skill to run an end-to-end test of your active remote Codex worker pool and confirm all probe jobs return valid result envelopes.

Frequently Asked Questions about remote-codex-test-flow

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

FAQPage Schema
How do I test remote Codex worker queue flows end to end?

Testing remote Codex worker queue flows involves submitting probe jobs to active workers, polling job status, tailing execution logs, and validating the returned result envelopes. This verifies both real worker execution and correct S3 protocol behavior.

How does S3 protocol smoke testing work without active workers?

S3 protocol smoke testing validates path structures, conditional writes, and status polling logic without requiring full worker execution. It checks the S3-only remote Codex queue behavior and ensures idempotent job submission succeeds even when no workers are active.

Can I inspect active worker hosts and tail job logs in remote Codex systems?

Yes, you can inspect active remote Codex worker hosts by viewing heartbeats, checking real-time job status, and tailing job execution logs. This helps diagnose queue or processing issues during end-to-end probe testing.

Do I need aws-cli to validate S3 worker job processing workflows?

Yes, aws-cli is required as a dependency to validate S3 worker job processing workflows. It provides the necessary commands to interact with S3 paths, check conditional writes, and retrieve result envelopes during end-to-end testing.

What is the best way to verify result envelopes from remote Codex probe jobs?

The best way to verify result envelopes is to submit probe jobs to your remote Codex worker pool and confirm workers claim, process tasks, and return data matching your required schema. This validates both execution and S3 protocol behavior.

Why does my S3 job polling not return valid results from remote Codex workers?

Invalid S3 job polling results often stem from incorrect conditional writes, failed idempotent job submission, or inactive worker heartbeats. Protocol smoke testing helps isolate S3 path structure issues from real worker execution failures.