Update every repo from one catalog
Add one instruction to Codex or Claude Code. The agent fetches AI Stack Registry once, reuses the same catalog across your repos, and shows you a plan before it edits anything.
Add this to AGENTS.md
## Model updates
Fetch https://aistackregistry.com/index.json once before checking my repos. Reuse that catalog for every repo in this update. Compare each repo's model IDs, limits, and provider settings. Tell me what should change before editing. After I approve, make the changes and run each repo's existing checks. If the catalog is missing a fact you need, tell me instead of guessing.
Then tell Codex which model you want and which repositories to check.
Add this to CLAUDE.md
## Model updates
Fetch https://aistackregistry.com/index.json once before checking my repos. Reuse that catalog for every repo in this update. Compare each repo's model IDs, limits, and provider settings. Tell me what should change before editing. After I approve, make the changes and run each repo's existing checks. If the catalog is missing a fact you need, tell me instead of guessing.
Then tell Claude Code which model you want and which repositories to check.
Install the shared model-update skill
Codex and Claude Code use the same SKILL.md. It reads
repository instructions and model configuration, fetches the catalog once, and reuses the same bytes for
every repo. It makes requested changes when the catalog supports them, skips unknown or blocked repos,
and reports what changed or was skipped.
Install for Codex
skill_dir="${CODEX_HOME:-$HOME/.codex}/skills/update-ai-models"
mkdir -p "$skill_dir"
curl --fail --silent --show-error \
https://aistackregistry.com/skill/SKILL.md \
--output "$skill_dir/SKILL.md"
Restart Codex, then ask it to use the update-ai-models skill for the repositories you name.
Install in a Claude Code project
mkdir -p .claude/skills/update-ai-models
curl --fail --silent --show-error \
https://aistackregistry.com/skill/SKILL.md \
--output .claude/skills/update-ai-models/SKILL.md
Restart Claude Code in the project, then ask it to use the update-ai-models skill.
Check pinned model facts in CI
CI can fetch the catalog once and compare a model ID, token limit, or provider setting your app pins. It will not choose an upgrade for you.
Check that a configured model ID exists
This example assumes config/ai.json contains a model field. Change the file and
field to match your repo. The job reads files. It does not update them or call a provider.
- name: Check configured AI model
shell: bash
env:
MODEL_CONFIG: config/ai.json
run: |
set -euo pipefail
catalog="$RUNNER_TEMP/aistackregistry-index.json"
curl --fail --silent --show-error \
https://aistackregistry.com/index.json \
--output "$catalog"
model_id="$(jq -r '.model' "$MODEL_CONFIG")"
if ! jq -e --arg id "$model_id" \
'.models | any(.api_model_id == $id or .registry_id == $id)' \
"$catalog" >/dev/null
then
echo "::error::Configured model is missing from AI Stack Registry: $model_id"
exit 1
fi
This check catches an unknown model ID. Add explicit comparisons for any limits or provider settings your app pins. Ask Codex or Claude Code to review new model releases when you want to choose an upgrade.
Updating more than one repo?
Fetch the catalog before the repo loop. Reuse the same file for every repo in the update.
Open index.json