codex-cache-update

Files (3)

• SKILL.md
• openai.yaml · agents/
• update.sh · scripts/

SKILL.md (first lines)

> [← Skills index](../../README.md)

## What it does

Refreshes the dev-kit Codex marketplace checkout and synchronizes the matching versioned cache directory so a new Codex session loads current plugin files.

Run the bundled updater from the repository root:

```bash
bash skills/codex-cache-update/scripts/update.sh
```

The updater first runs `codex plugin marketplace upgrade dev-kit`, then reads
the marketplace plugin version and synchronizes the marketplace checkout into
`$HOME/.codex/plugins/cache/dev-kit/dev-kit/<version>` with `rsync --delete`.
This second step is required because the marketplace command can report
“already up to date” while the versioned cache still contains stale files.

> Note: the SessionStart hook `.codex-plugin/hooks/plugin-cache-refresh.sh`
> runs the same rsync automatically on every session start (with SHA-drift
> detection, so it no-ops when the cache is already current). Manual
> invocation is only needed for explicit verification, CI fixups, or
> out-of-band triggers.

## Verification

The command prints the marketplace commit, cache directory, and a final
`cache synchronized` line. Confirm the source and cache manifests have the
same version before restarting Codex. Use `--dry-run` to inspect differences
without changing the cache.

## Configuration

Use these environment variables when the default Codex paths are different:

```bash
CODEX_MARKETPLACE_DIR="$HOME/.codex/.tmp/marketplaces/dev-kit" \
CODEX_CACHE_ROOT="$HOME/.codex/plugins/cache/dev-kit/dev-kit" \
bash skills/codex-cache-update/scripts/update.sh
```

The updater excludes Git metadata, worktrees, generated dev-kit state, Python
bytecode, and evaluation caches from the installed cache.

## Next step

Restart Codex so the refreshed plugin cache is loaded by the new session.

From sh-ai-x/dev-harness-kit, MIT.

More from sh-ai-x/dev-harness-kit