kitepon

Codex Sidecar — Development skill for Claude Code

Development community

Safe Codex sidecar execution for reviews, codebase exploration, risk checks, and isolated worktree fixes.

How to install Codex Sidecar

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kitepon/codex-sidecar and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Codex Sidecar does

Safe Codex sidecar execution for reviews, codebase exploration, risk checks, and isolated worktree fixes.

Alternatives in Development

Om Tidy — Self-maintenance pass — acts on every hygiene flag: archives completed work, groups loose clusters, splits ove 4.6k ★
Code Review Graph — Local knowledge graph for Claude Code 3.7k ★
Overnight PRs — Autonomous overnight loop — verify issues against the codebase, close stale ones, ship PRs through /ship (bug 324 ★

README

codex-sidecar — safe Codex calls for real repos

codex-sidecar

[![npm version](https://img.shields.io/npm/v/codex-sidecar-cli.svg?color=cb3837&logo=npm&label=codex-sidecar-cli)](https://www.npmjs.com/package/codex-sidecar-cli) [![npm version](https://img.shields.io/npm/v/codex-sidecar-mcp.svg?color=cb3837&logo=npm&label=codex-sidecar-mcp)](https://www.npmjs.com/package/codex-sidecar-mcp) [![CI](https://github.com/kitepon/codex-sidecar/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon/codex-sidecar/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/codex-sidecar-cli.svg?color=blue)](LICENSE) [![node](https://img.shields.io/node/v/codex-sidecar-cli.svg?color=339933&logo=node.js&logoColor=white)](https://nodejs.org) [![GitHub release](https://img.shields.io/github/v/release/kitepon/codex-sidecar?color=24292e&logo=github)](https://github.com/kitepon/codex-sidecar/releases)

**English** · [日本語](README.ja.md)

**Run Codex as a safe, isolated sidecar — and get machine-readable answers, not chat transcripts.** `codex-sidecar` lets humans, Claude Code, MCP clients, and hooks ask Codex for code review, exploration, risk checks, and scoped fixes, returning one structured `SidecarResult` JSON per call without ever touching your active working tree.

Built and maintained by [Quo](https://x.com/QLyun35332) at [kitepon.dev](https://kitepon.dev/en).

Requires Node.js 22.13.0 or newer. The core loads the built-in `node:sqlite` module without an experimental flag, so older Node releases are unsupported.

**Ownership boundary:** this repository owns standalone installation, configuration, state/schema migration, diagnostics, recovery, updates, releases, and isolated Codex execution. [dotagents](https://github.com/kitepon/dotagents) consumes the public contract for cross-product wiring and compatibility; it does not control this product's internal operation.

[Usage](docs/USAGE.