codex-harness

Community

Run Codex safely in isolated worktrees with PRs

Authorunclehowell
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a reproducible, safe way to run Codex code generation inside an isolated Git worktree, ensuring deterministic edits, automatic verification, logging, and optional pull‑request creation without polluting the main repository.

Core Features & Use Cases

  • Isolated Worktree: Runs Codex in a temporary Git worktree derived from a base branch, protecting the main codebase.
  • Automatic Verification: Executes a user‑specified test or format command after Codex changes.
  • Push & PR Automation: Pushes the new branch and optionally opens a pull request via GitHub CLI, complete with logs.
  • Use Case Example: A developer can task Codex to fix a login bug, have the changes verified with npm test, and automatically submit a PR for review.

Quick Start

Ask the codex-harness skill to run Codex with a fix-login task on the main branch, verify with npm test, and create a PR.

Dependency Matrix

Required Modules

gitcodexgh

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: codex-harness
Download link: https://github.com/unclehowell/unclehowell/archive/main.zip#codex-harness

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.