Official Shared Alpha

Codex Pet League

Server authority for Codex hatch-pets.

Hatch in Codex. Import through CLI/MCP. Use the web for profiles, ladder, replays, battle rooms, status, and support.

Install CLI/MCP

1. Hatch in CodexCreate the local pet with OpenAI's official hatch-pet skill.

2. Import onceLock the official League identity through CLI or MCP.

3. Inspect stateUse the web for public records, replays, and visual battle rooms.

Webprofiles, ladder, replays, battle room, status, support

CLI/MCPdiscovery, import, report drafts, bridge checks

Official Alpha

League Console

Your Codex pet is server-owned after import.

Server Live CLI/MCP Connected Server-Owned

League Lobby Season 01 Server Resolved

League Actions

Connect your Codex pet.

Use this console to inspect server-owned state, open visual battle rooms, and return to CLI/MCP workflows. The first official pet must come from your local Codex hatch-pet package and is permanent for this League account.

Codex CLI setup npm run cli -- doctor npm run cli -- pet discover-hatch npm run cli -- setup --path <hatch-pet-folder> --yes

Active League Pet Rank pending

Setup Track

CLI/MCP first

Email verifiedSign in from the top-right modal.

CLI doctorConfirm your local bridge reaches League.

hatch-pet packageDiscover the local OpenAI pet package.

Official pet lockedPermanent first active selection.

Daily Caps

Growth budget

CLI/MCP Reminder

Source of truth

Import and bridge checks run through CLI/MCP.

Setup

Connect League

Connect Codex, CLI/MCP, and the official League server.

Email Sign-In Status

League session

Verified emailSigned in through League email-code login.

League sessionActive, separate from Codex ChatGPT sign-in.

Account authorityLeague server session and records.

CLI/MCP Install

First active League pet selection is permanent.

1. Check League npm run cli -- doctor 2. Check bridge npm run cli -- bridge status 3. Find local hatch packages npm run cli -- pet discover-hatch 4. Inspect one package npm run cli -- pet inspect-hatch --path <folder> 5. Lock official pet npm run cli -- setup --path <folder> --yes

Import Checklist

In order

Hatch-pet package found in CodexCreated locally with the official skill.

Package inspectedManifest and atlas verified.

Official pet importedValidated by the League server.

Permanent identity lockedFirst active pet becomes official.

Trust Boundary Flow

Local hatch-pet packageCreated and owned on your machine.

CLI/MCP bridgeImports the package.

League validationValidates integrity and rules.

Canonical asset hashRecords the official asset.

Permanent active petServer-owned identity begins.

First active League pet is permanent. Local file changes cannot alter ranked state.

Setup Resources

User setup guideStep-by-step walkthrough.

MCP registrationRegister your MCP client.

TroubleshootingCommon setup checks and fixes.

Local smoke tools

Only for local browser tests.

Reports

Training Reports

Convert Codex work summaries into server-scored Pet XP and Style XP.

Reports Guide

Recommended CLI/MCP

Primary path

Recommended because Codex work context lives in CLI/MCP.

codexpet report draft codexpet report submit codexpet xp status

Daily Progress

Web Secondary Submit

Companion path

Files changed Tests run

No draft yet.

Review Policy & Outcomes

AcceptedFull XP awarded as submitted.

DowngradedPartial XP awarded based on evidence.

Held for ReviewManually reviewed for anomalies.

Style XP OnlyNo stat growth when quality is low.

RejectedNo XP awarded.

Raw source code and full Codex transcripts are not stored.

Battles

Battle Room

Server-resolved simultaneous turns.

30s turns. Third consecutive timeout becomes AFK loss.

Matchmaking

30s simultaneous turns

Mode Opponent LP

No matchmaking activity.

Battle Room

Server resolved

Skill

Turn Log

Replay chain

No active battle.

Integrity & Replay

Replay hashGenerated by server-owned battle log.

Turn noncePrevents stale or replayed actions.

Room snapshotLocks stats, loadout, and asset hash.

Ranked settlementApplied only after server resolution.

Server owns HP, energy, cooldowns, RNG, deadlines, and ranked results.

Replays

Tamper-evident battle records.

Replay List

Verified records

Integrity Chain

Room snapshotCaptured at start

Turn nonce chainPer-turn commitment

Replay hashTamper-evident

Settlement hashFinal server result

VerificationVerified

Ladder

Ranked Ladder

Server-owned LP and Battle Class rankings.

#	Pet	Class	Rank	LP	Publish	Record

Pet

Pet Identity

Permanent League record for your Codex hatch-pet.

Identity Summary

Skill Nicknames (cosmetic only)

Asset Visibility

Public profileVisible

Ranked eligibleYes

Moderation statusClear

Canonical CDN URLServer-owned asset copy.

Local file changes after import do not affect ranked state.

Status

Status & Support

Public operations and support routes.

Public Status

All systems operational

League APIOperational1m ago

Battle ResolverOperational1m ago

PostgresOperational1m ago

RedisOperational1m ago

R2 AssetsOperational1m ago

Resend EmailOperational1m ago

OpenAI ModerationOperational1m ago

GitHub MonitorOperational15m cadence

Incident Snapshot

Open Abuse Alerts0

Held Reports0

Moderation Queue0

Active Battles0

Support

Support Routes

Documentation, public issues, and private support paths.

Support Routes

DocumentationProduct docs, concepts, and references.

User Setup GuideStep-by-step setup for CLI/MCP.

GitHub IssuesReport public bugs and install problems.

Support Emailsupport@codexpetz.com

Do not share API keys or session tokens in public issues.

Public Pages

Privacy Terms Support Page Status Page

Owner Admin

Admin Operations

Owner-only moderation, audit, and incident tools.

Server Event Log

Admin Operations

Admin console unavailable.