apple-agent-kit 2.2.0 → 2.4.0

package/README.md

@@ -5,7 +5,7 @@
 [![Changelog](https://img.shields.io/badge/changelog-CHANGELOG.md-blue)](CHANGELOG.md)
 
 Status: Stable
-Version: 2.2.0
+Version: 2.4.0
 
 ## Overview
 
@@ -35,6 +35,8 @@ npx apple-agent-kit
 
 This adds this repository as a Claude Code plugin marketplace and installs the `apple-agent-kit` plugin, so its Skills, Knowledge Contracts, and routing become available inside Claude Code sessions. Requires the `claude` CLI to already be installed.
 
+Codex CLI users: the same installer detects `codex` and prints install instructions instead of erroring. See [.codex/INSTALL.md](.codex/INSTALL.md) for the plugin-marketplace command and a manual clone-and-symlink fallback.
+
 ## Architecture
 
 Apple Documentation
@@ -98,9 +100,9 @@ Full routing tables: [skills/index.md](skills/index.md). Domain build order and
 
 ## What's New
 
+- 2026-08-23 — Codex CLI support landed. This repo's Skills are now loadable from OpenAI's Codex CLI, not just Claude Code, with zero changes to any Knowledge Contract, Skill, Reference, or Workflow — Codex reads the same `SKILL.md` files directly via a single repo-root manifest, `.codex-plugin/plugin.json`, that points at the existing `skills/` directory as a whole. No per-domain translation file exists or is needed. `.codex/INSTALL.md` documents both install paths (Codex's plugin marketplace, or a manual clone-and-symlink fallback), and `npx apple-agent-kit` now detects a Codex-only environment and prints the right instructions instead of erroring.
 - 2026-08-23 — Tier 2's 78 Knowledge Contracts and 17 Skills finished their first full pass through every Level 4 check, L4.1 through L4.5. The last of those, L4.5 — does the page a rule cites actually say what it's quoted as saying — had been explicitly left open by two earlier reviews because answering it means fetching live Apple documentation, not just reading the repository. Fetching it found what reading alone never could: fourteen fabricated-but-plausible quotes attached to otherwise-correct rules, a pair of stale rule-number citations, and one rule whose entire premise — that PassKit ships no SwiftUI equivalent for adding a pass to Wallet — had gone false the moment Apple shipped one, silently invalidating a coupling an earlier review had verified under the premise that held when it was written.
 - 2026-08-09 — The two-domain experiment was tested the way it was meant to be tested, and it passed with one gap. The idea under test: settle in writing, before any rule is authored, every boundary a new domain shares with the existing ones. Nine such boundaries were settled for the photo and location domains, and until now the only evidence they worked came from the person writing to them — not from someone using the result. So a realistic feature was put through the kit end to end: pick photos from the library, show where each one was taken, and react when the user comes back to that place later with the app closed. Four of the settled boundaries were exercised and all four held, including the one an agent is most likely to get wrong. The gap is elsewhere, and it is the interesting part: the photo library hands back a location — the place a photo was taken travels with the photo, and reading it needs no location permission at all — but neither domain said so, so a feature asking that question either stopped with nothing or asked the user for a permission it would never use. The reason nobody wrote it down is that the boundaries were settled by walking each new domain against the domains that already existed, which cannot see the seam between two domains built at the same time. That is now a written rule, along with the review question that would have caught it.
-- 2026-08-09 — Photo library support shipped, and it closed the two-domain pilot by contradicting the note written to guide it. The pilot's premise is that boundaries between a new domain and the existing ones are cheaper to settle in writing before any rule is authored than to discover later by testing. Four boundaries were settled in advance for photos, and the one that mattered most had been recorded as a repeat of a defect found twice before: two other domains had told an agent to wrap a screen component for use in modern UI code without pointing at the rule that makes the wrap correct, and photos was expected to be the third. Checking Apple's own documentation while writing showed the opposite — the photo picker already ships a modern-UI-native version, so the correct instruction here is not to wrap it at all. The wrap is still needed, but for a different call entirely: the one that lets a user revise which photos they have shared. Two rules now sit in the same domain saying opposite things about the same technique, deliberately, each naming the call it governs. The advance note had named the right neighbour and the wrong symbol, which would have produced a confidently wrong instruction had it been followed as written. Six rule documents, a source index, and a router entry landed with it, every rule quoted from Apple's pages rather than recalled.
 Only the 3 most recent entries live here — see [CHANGELOG.md](CHANGELOG.md) for the full release history.
 
 ## Contributing

package/bin/install.js

@@ -14,18 +14,37 @@ const commands = [
   ['claude', ['plugin', 'install', `${PLUGIN_NAME}@${MARKETPLACE_NAME}`]],
 ];
 
-function checkClaudeInstalled() {
-  const result = spawnSync('claude', ['--version'], { stdio: 'ignore' });
-  if (result.error || result.status !== 0) {
-    console.error(
-      'Error: the `claude` CLI was not found on PATH. Install Claude Code first: https://code.claude.com/docs/en/quickstart'
-    );
-    process.exit(1);
-  }
+function commandExists(cmd) {
+  const result = spawnSync(cmd, ['--version'], { stdio: 'ignore' });
+  return !result.error && result.status === 0;
+}
+
+function printCodexInstructions() {
+  console.log('The `claude` CLI was not found on PATH, but `codex` was.');
+  console.log('Apple Agent Kit installs into Codex from inside a Codex session, not from this script.');
+  console.log('');
+  console.log('Run inside Codex:');
+  console.log(`  /plugin marketplace add ${REPO}`);
+  console.log('');
+  console.log('Then install the `apple-agent-kit` plugin from that marketplace and restart Codex.');
+  console.log(`For a manual install instead, see: https://github.com/${REPO}/blob/main/.codex/INSTALL.md`);
+}
+
+function printNeitherFoundError() {
+  console.error('Error: neither the `claude` nor the `codex` CLI was found on PATH.');
+  console.error('Install Claude Code: https://code.claude.com/docs/en/quickstart');
+  console.error('...or install Codex CLI, then re-run this command.');
 }
 
 function run() {
-  checkClaudeInstalled();
+  if (!commandExists('claude')) {
+    if (commandExists('codex')) {
+      printCodexInstructions();
+      process.exit(0);
+    }
+    printNeitherFoundError();
+    process.exit(1);
+  }
 
   for (const [cmd, args] of commands) {
     const printable = [cmd, ...args].join(' ');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-agent-kit",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Installs the Apple Agent Kit Claude Code plugin via the claude CLI.",
   "bin": {
     "apple-agent-kit": "bin/install.js"