Codex Plugin for Claude Code 2026 - AI-Powered Background Task & Code Review Automation
SaferSkills independently audited codex-forge (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
In software development, we often treat code review as a bottleneck—a necessary evil that slows velocity. But what if a background process could handle the cognitive load while you focus on architecture? This repository introduces a paradigm shift: an autonomous orchestration layer that integrates OpenAI Codex with Claude Code to perform delegated code reviews, refactoring tasks, and multi-model analysis—all running as asynchronous background jobs with full job control.
Version 1.0.0 | MIT License | Works with OpenAI API & Claude API
Imagine having a tireless junior developer who never sleeps, never gets tired, and consults both Codex and Claude for every decision. That is what this project delivers. We treat code review not as an event but as a continuous, background process—like a heartbeat monitor for your repository.
The orchestration engine sits between your CI/CD pipeline and the LLM APIs, managing jobs, handling retries, and providing real-time status. This is not just another code review tool; it is a delegation framework that turns AI models into collaborative workers.
SEO Keywords: AI code review automation, background job control, Codex Claude integration, autonomous code analysis, multithreaded LLM orchestration, 2026 software development pipeline.
graph TB
subgraph "User Layer"
CLI[Console Interface]
UI[Responsive Web UI]
end
subgraph "Orchestration Engine"
Scheduler[Job Scheduler]
Queue[Background Job Queue]
Monitor[Job Monitor & Control]
end
subgraph "AI Model Layer"
Codex[OpenAI Codex API]
Claude[Claude API]
Router[Model Router]
end
subgraph "Output Pipeline"
Review[Code Review Report]
Refactor[Refactored Code]
Logs[Execution Logs]
end
CLI --> Scheduler
UI --> Scheduler
Scheduler --> Queue
Queue --> Router
Router --> Codex
Router --> Claude
Codex --> Review
Claude --> Review
Codex --> Refactor
Claude --> Refactor
Monitor --> Queue
Monitor --> Logs
Review --> UI
Refactor --> UI
Logs --> MonitorThe diagram above illustrates a job orchestration architecture where user commands flow into a scheduler, which enqueues tasks. The model router then dispatches work to either Codex or Claude based on task type, load balancing, or user preference. Background monitoring allows pausing, resuming, or canceling jobs mid-execution.
The system does not just review code; it acts on findings. If Codex identifies a performance bottleneck, the engine can autonomously generate a refactored version and submit it as a suggestion—all in the background.
Jobs are not fire-and-forget. The engine provides full control:
When Codex and Claude disagree on a refactoring approach, the orchestrator generates a diff report highlighting both options. You get the best of both models without manual intervention.
The job scheduler implements exponential backoff and token bucket algorithms. Even during peak API usage, jobs complete—just slower. No dropped tasks.
Access the system via a lightweight web dashboard (React-based) or from the command line. The UI updates in real-time using WebSockets, showing job progress, token usage, and model activity.
Supports Python, JavaScript, TypeScript, Go, Rust, Java, and C++. Each language has model-specific prompt templates optimized for Codex and Claude.
The system retries failed jobs up to five times with adaptive delays. Combined with job monitoring, this provides effectively around-the-clock reliability for overseas teams.
Instead of blindly sending entire files, the engine uses tree-sitter to extract only relevant functions and classes. This keeps API costs low and responses fast.
All generated code is executed in a read-only sandbox before being presented. No AI output touches your production environment without explicit approval.
The system tracks token usage per project, per user, and per job. This enables cost allocation and budgeting for enterprise deployments using OpenAI and Claude APIs.
Create a profile in ~/.codex-plugin-cc/config.yaml to define model preferences, job routing, and notification settings.
profiles:
default:
models:
review: claude-api
refactor: openai-codex
analyze: both
job_settings:
max_retries: 5
retry_backoff: exponential
timeout_minutes: 30
notifications:
on_complete: stdout
on_failure: webhook
language_preferences:
python: claude-api
javascript: openai-codex
go: both
security:
sandbox_enabled: true
auto_approve_refactor: falseThis configuration tells the orchestrator to use Claude for review tasks, Codex for refactoring, and both for deep analysis. Python tasks route to Claude, while JavaScript goes to Codex.
$ codex-plugin-cc review --path ./src --background --profile default
[INFO] Initializing job scheduler...
[INFO] Enqueued review job: JOB-2026-04-001
[INFO] Routing to Claude API for Python files...
[INFO] Routing to Codex API for JavaScript files...
[INFO] Job JOB-2026-04-001 is running in background (PID: 1423)
[INFO] Use `codex-plugin-cc status JOB-2026-04-001` to check progress.
[INFO] Use `codex-plugin-cc pause JOB-2026-04-001` to suspend execution.
$ codex-plugin-cc status JOB-2026-04-001
[STATUS] Job JOB-2026-04-001
State: Running
Progress: 45%
Files Reviewed: 12/26
Tokens Used: 14,230
Estimated Remaining: 3m 12s
Last Model Activity: Claude API responded with 3 issues
$ codex-plugin-cc control JOB-2026-04-001 --pause
[INFO] Job JOB-2026-04-001 paused. Use --resume to continue.The console interface provides real-time job control reminiscent of background process management in operating systems, applied to AI-driven code analysis.
| Operating System | Supported | Notes |
|---|---|---|
| Linux (Ubuntu 22.04+) | ✅ | Fully tested |
| macOS (Monterey+) | ✅ | Requires Xcode CLI tools |
| Windows 10/11 | ✅ | WSL2 recommended |
| Windows Server 2022 | ✅ | PowerShell core support |
| FreeBSD | ⚠️ | Community support only |
| Alpine Linux | ❌ | Dependency conflicts |
The orchestrator uses Python 3.10+ and leverages asyncio for non-blocking job execution. All major operating systems are supported through either native or WSL2 environments.
The system interfaces with the Codex API using a custom session manager that handles:
Minimum configuration: Set OPENAI_API_KEY in environment variables. Optionally set OPENAI_ORG_ID for enterprise users.
Claude integration uses Anthropic's messaging API with:
Minimum configuration: Set ANTHROPIC_API_KEY in environment variables.
When both APIs are configured, the orchestrator can run a consensus workflow where both models analyze the same code and the output presents a merged review with attributed findings.
The web dashboard is built with React and Tailwind CSS, supporting:
The CLI output is also i18n-aware, displaying error messages and status updates in the configured language.
This software is provided as-is under the MIT License. The authors are not responsible for:
Always review AI-generated code before merging into production branches. Use the sandbox mode for critical systems.
This project is licensed under the MIT License. See the LICENSE file for full terms.
AI Code Review Orchestrator 2026 – Turn your CI/CD pipeline into an autonomous intelligence layer.
Repository generated for demonstration purposes. The concept described is novel and distinct from the original "codex-plugin-cc" repository, focusing on background job orchestration and multi-model delegation rather than direct plugin integration.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.