Back to Skills

codex-status

Check the current status of Codex collaboration. Use when user says codex status, check codex, or collaboration status.

15stars2forksUpdated 3/25/2026

Security Assessment

Safe(100/100)
Security Score100/100

About codex-status

The Codex Status skill provides a streamlined way to monitor and manage the current state of the Claude-Codex collaboration within a project. It addresses the challenge of tracking AI-assisted tasks by offering a centralized mechanism to check whether Codex is idle, processing a request, or has completed a task. By consolidating status information and task previews, it helps developers maintain situational awareness of ongoing AI interactions without manually navigating multiple files or directories.

This skill offers several key capabilities. Users can read the current status of Codex to determine if it is idle, pending, working, or done. When a task is active, it allows the user to view and summarize the current task, including its type and a brief description. Once a task is completed, the skill can provide a preview of the response generated by Codex. Additionally, it offers suggested actions tailored to the current status, guiding the user on how to proceed with delegation or reviewing results. It ensures that all operations are performed relative to the `.agent-collab` directory, automatically resolving the project root when necessary.

Typical use cases for this skill include managing AI-assisted code reviews, monitoring implementation tasks, and reviewing AI-generated plans or outputs. It is particularly useful for developers, project managers, or technical leads who rely on Codex for collaboration in software projects. By providing a clear overview of task progress and offering actionable recommendations, the skill enhances productivity and ensures efficient coordination between human users and AI collaborators.

FAQ

How do I check the current status of Codex?

You can check the status by reading the `$AGENT_COLLAB_DIR/status` file. The status can be 'idle', 'pending', 'working', or 'done', each indicating the current state of Codex's task processing.

What should I do if Codex is idle?

If the status is 'idle', the skill suggests delegating tasks using commands like /codex-review, /codex-implement, or /codex-plan-review.

What happens if the `.agent-collab` directory is missing?

The skill will attempt to resolve the directory by traversing the project root. If it cannot find `.agent-collab`, it will stop and prompt you to specify the project root.

Can I preview a response before it is fully completed?

No, response previews are only available when the status is 'done'. If Codex is 'pending' or 'working', you need to wait until completion.

Which users benefit most from this skill?

Developers, project managers, and technical leads who coordinate tasks with Codex will find this skill useful for monitoring progress and managing AI-assisted work efficiently.

Install codex-status

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill