mcpbeat

Codex Settings Sync

redis/codex-settings-sync

Use when the user wants to migrate Codex state in ~/.codex into Agent Filesystem and mount the same shared Codex memory/settings across multiple computers. Recommends a .afsignore before migration and defaults to excluding worktrees, caches, logs, and temporary files.

663 tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
26
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/redis/agent-filesystem --skill codex-settings-sync

What comes with it

127 bytes besides the instruction
assets/.afsignore

The instruction itself

6 sections, as written by the author

Codex Settings Sync

Use this skill when the goal is to share Codex state across machines by moving ~/.codex into Agent Filesystem, then mounting that same Redis-backed volume on other computers.

Default stance

  • Recommend a root ~/.codex/.afsignore before migration.
  • Default to excluding worktrees/.
  • Treat cache/, tmp/, logs/, *.log, *.tmp, *.pid, and *.sock as good default exclusions.
  • If the user appears to care about restoring local checkout state inside Codex, call out worktrees/ as a choice point before migrating.

Open the bundled starter ignore file at assets/.afsignore and adapt it to the user's needs.

Migration workflow

  • Ask the user to stop Codex on the machines involved, or verify that it is already closed.
  • Ensure agent-filesystem is built with make.
  • Configure afs to point at the shared Redis instance.
  • Create or update ~/.codex/.afsignore before migration.
  • On the source machine, run ./afs ws import --mount-at-source .codex ~/.codex.
  • Explain that the imported workspace is mounted at ~/.codex, and the workspace name is .codex.
  • On each additional machine, move aside any existing ~/.codex, choose mount mode with ./afs config set --mode mount if you want a live mount there, then run ./afs ws mount .codex ~/.codex.
  • Verify with ./afs status and ls -la ~/.codex.

Secondary machine config

Point the CLI at the same control plane or Redis database. Then run

./afs config set --mode mount for live mount mode, or

./afs config set --mode sync for sync mode, before mounting .codex at

that machine's ~/.codex.

Notes to surface

  • afs ws import honors ~/.codex/.afsignore if present.
  • .afsignore uses .gitignore-style pattern syntax.
  • Excluding a directory like worktrees/ is usually safer than syncing it.
  • Avoid using the same shared ~/.codex from multiple active computers at the same time.
  • Keep any .local-backup directories until the setup is stable.

Rollback

Source machine rollback:

./afs ws unmount ~/.codex

Secondary machine rollback:

./afs ws unmount ~/.codex
rm -rf ~/.codex
mv ~/.codex.local-backup ~/.codex

How to use it

Copy the folder

Take redis/codex-settings-sync from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.