Codex Sidecar banner
kitepon kitepon

Codex Sidecar

Development community

Description

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

Installation

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

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.