romangalaxys10-spec

The Codex Chess Playing Agent — Development skill for Claude Code

Development community

Autonomous macOS Chess Agent with Computer Use - powered by GLM 5.6 Luna & Agent Skills standard.

How to install The Codex Chess Playing Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open romangalaxys10-spec/The-Codex-Chess-Playing-Agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What The Codex Chess Playing Agent does

Autonomous macOS Chess Agent with Computer Use - powered by GLM 5.6 Luna & Agent Skills standard.

Alternatives in Development

Ralphy — My Ralph Wiggum setup, an autonomous bash script that runs Claude Code, Codex, OpenCode, Cursor agent, Qwen & 2.8k ★
Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Chops — 1,000+ macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp 1.1k ★

README

♟️ The Codex Chess Playing Agent 🚀

**Autonomous Computer-Use Chess Agent for macOS** — Pioneered with **GPT 5.6 LUNA** (Codex), then upgraded by **GLM 5.3 via ZCode** to fully control the desktop chess game, piece by piece, via macOS Accessibility.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![macOS Compatible](https://img.shields.io/badge/macOS-Sonoma%20%7C%20Sequoia-black.svg?logo=apple)](https://apple.com) [![Agent Ready](https://img.shields.io/badge/Agent%20Ready-Codex%20%7C%20Claude%20%7C%20ZCode%20%7C%20Trae-green.svg)](#)

🌟 Origin Story: GPT 5.6 LUNA Creates the Codex Version

The original breakthrough came from **GPT 5.6 LUNA** running in Codex: give an LLM direct "Computer Use" powers over macOS and challenge the native Apple Chess engine. LUNA pioneered the core insight of this repo — **skip OCR entirely and sniff the game state** straight out of Chess.app's autosaved document (`~/Library/Containers/com.apple.Chess/...`), reconstruct the board, and drive the desktop via AppleScript. That architecture — state sniffing + desktop control, packaged as a portable Agent Skill — is LUNA's contribution, and it works across Codex, Claude Code, Antigravity, ZCode, Trae, and Cursor.

🔥 The Upgrade: GLM 5.3 (via ZCode) Makes It Actually Move Pieces

On 2026-08-23, **GLM 5.3 running inside ZCode** loaded this skill from GitHub and pointed it at a **live, already-open Chess.app game** on the user's Mac desktop. What followed was a genuine agentic debugging session — three dead ends, one accidental discovery, and a final executor that plays moves deterministically with zero vision and zero mouse math.

Dead end #1 — the parser was reading the wrong file format

The shipped parser looked for a `` XML tag inside the `.game` file. Apple Chess actually persists a **plist** whose keys are `Moves` (newline-separated coordinate moves like `d2d3`) and `Position` (a live FEN string). GLM 5.3 rewrote the reader