codex logo
OpenAI · Codex

ChooChoo for Codex.

Ship better code, faster. Without the standards drift.

OpenAI's cloud-based coding agent for autonomous software development. ChooChoo generates AGENTS.md and SKILLS.md so Codex knows your code standards, available skills, and guardrails before it writes a single line.

Configuration

ChooChoo creates and manages your Codex config.

Codex reads AGENTS.md and SKILLS.md to understand your project before it acts. ChooChoo compiles both from your codebase — covering safety, context, patterns, and performance guardrails.

  • AGENTS.md with code standards, boundaries, and architecture decisions
  • SKILLS.md mapping available capabilities to source files
  • Security guardrails and performance constraints baked in
AGENTS.md
# AGENTS.md
# Generated by ChooChoo — do not edit by hand.
# Run: choochoo context generate

## Project: payments-api
Stack: Python 3.12 · FastAPI · PostgreSQL · Redis
Style: Ruff (line-length=100) · strict mypy
Tests: pytest · coverage ≥ 85% enforced on CI

## Standards
- Validate all inputs with Pydantic at API boundaries
- No raw SQL — use SQLAlchemy ORM
- Never log secrets, tokens, or payment data
- Annotate all public functions with types

## Boundaries
READ:   src/** · tests/** · docs/**
WRITE:  src/** · tests/**
NEVER:  .github/** · migrations/** · infra/**

## Architecture Decisions
ADR-001  JWT (RS256) for auth
ADR-004  Event-driven webhooks via Redis Streams
ADR-007  API versioning under /v1/, /v2/ namespaces
SKILLS.md
# SKILLS.md
# Generated by ChooChoo — do not edit by hand.

## auth
JWT token lifecycle: creation, validation, refresh.
  Entry: src/auth/service.py
  Tests: tests/auth/

## payments
Stripe integration: charges, subscriptions, webhooks.
  Entry: src/payments/processor.py
  Note:  Never log STRIPE_KEY or card numbers

## database
SQLAlchemy sessions and query patterns.
  Entry: src/db/session.py
  Rule:  Always use get_db() dependency injection

## notifications
Email (SendGrid) and SMS (Twilio) dispatch.
  Entry: src/notifications/dispatch.py

Why use ChooChoo with Codex?

Autonomous agents need context to act autonomously well. ChooChoo provides the foundation.

Consistent Output

Generated code follows your linting rules from the start, reducing cleanup work before code review.

Fewer Iterations

The AI understands your standards upfront, producing acceptable code faster and with less back-and-forth.

Team Alignment

Everyone's AI assistant generates code that matches your team's style guide — automatically.

Zero Configuration

Get started instantly with sensible defaults that work out of the box for most projects.

Type-Safe Code

Strict linting rules catch potential bugs and enforce type safety before they reach review.

AI-Ready Rules

Purpose-built rules that AI models understand and follow consistently, session after session.

Ready to unleash Codex?

Give Codex the context it needs to act autonomously within your team's standards.