Skip to content

v0.1.0

Choose a tag to compare

@tkimball83 tkimball83 released this 06 Sep 18:52

Use Claude from Codex for code reviews, delegated work, and conversation handoffs, powered by your local Claude account.

Features

  • Code review: $claude:review checks implementation changes for correctness issues.
  • Adversarial review: $claude:adversarial-review challenges designs, assumptions, tradeoffs, and failure modes, with optional focus text and structured findings.
  • Flexible review scope: Automatically review local changes in a dirty checkout or branch changes in a clean checkout. Select a base branch or scope explicitly for focused comparisons.
  • Foreground and background jobs: Wait for reviews and rescue tasks or launch them in the background with a tracked job ID.
  • Delegated investigation and implementation: $claude:rescue investigates repositories and performs authorized edits and validation using Claude's native tools and sandboxed Bash. Supply tasks as inline text, multiline prompt files, or piped stdin.
  • Persistent conversations: Continue rescue and gate sessions with --resume or --resume-last, start a new conversation with --fresh, or use the returned claude --resume SESSION_ID command interactively. Failed and cancelled jobs remain resumable when a session ID is available.
  • Conversation handoff: $claude:transfer seeds Codex user and assistant text into a persistent Claude session, with automatic transcript discovery and explicit source selection.
  • Live progress and history: $claude:status displays execution phases, progress summaries, elapsed time, session IDs, and follow-up commands. Job ID prefixes, expanded history, and configurable waiting help track ongoing work.
  • Results and cancellation: $claude:result retrieves full output and diagnostics; $claude:cancel cancels active jobs. Explicit job IDs support access across sessions in the same checkout.
  • Session lifecycle management: The SessionEnd hook cancels active jobs and cleans up session records. Retained history prioritizes recently updated results while preserving active worker records.
  • Automatic review gate: An optional per-workspace Stop gate reviews the previous Codex turn and returns an ALLOW or BLOCK decision. Gate jobs support status, results, cancellation, and persistent continuation.
  • Setup and diagnostics: $claude:setup checks Node, npm, Claude, and authentication readiness, guides installation, and enables or disables the workspace review gate.
  • Model and effort controls: Reviews and rescue support explicit Claude model selection; rescue also supports effort selection. Omitted selections use Claude's defaults.
  • Command-line controls: Workspace selection, JSON output, and explicit boolean values support scripting and automation.

Install

codex plugin marketplace add linuxhq/cc-plugin-codex
codex plugin add claude@linuxhq

Start a new Codex session and run $claude:setup.