pull-codex-config

Clone or fast-forward a local dot-codex checkout while preserving uncommitted changes.

10|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/marcocello/dot-codex --skill pull-codex-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pull-codex-config
Source: https://github.com/marcocello/dot-codex/tree/main/skills/pull-codex-config
Command: npx skills add https://github.com/marcocello/dot-codex --skill pull-codex-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill safely updates a local checkout of the dot-codex repository without overwriting your work, so your Codex configuration stays current and controlled.

Core Features & Use Cases

  • Safe repository refresh: Clones the repo when missing and fast-forwards an existing checkout when it is clean.
  • Local-change protection: Stops and reports modified files instead of stashing, resetting, or silently discarding work.
  • Codex config sync: Keeps Codex skills, scripts, AGENTS rules, and related configuration aligned with the upstream repository.
  • Use case: Run it when you want the latest harness or skill updates before continuing an agent session.

Quick Start

Ask the assistant to pull the latest dot-codex configuration using this skill and report whether the checkout was cloned or fast-forwarded.

Frequently Asked Questions about pull-codex-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely pull a git repository update without overwriting local changes?

To safely pull a git repository update without losing local changes, this Skill clones missing repos or fast-forwards existing clean checkouts, stopping to report modified files instead of stashing or discarding work.

What happens if I have uncommitted changes when syncing my Codex configuration?

When syncing your Codex configuration with uncommitted changes, the process halts and reports the dirty files. It requires explicit user approval before proceeding and never silently stashes or resets your work.

How do I refresh local dot-codex skills and scripts to the latest upstream version?

To refresh local dot-codex skills and scripts, the Skill fast-forwards your existing clean checkout to the latest upstream version, keeping AGENTS rules and configuration aligned without overwriting uncommitted work.

Does this repository sync method require a clean git worktree?

Yes, this repository sync method requires a clean git worktree for fast-forwarding. It validates the Git remote and performs clean-worktree checks, only proceeding with dirty pulls after explicit user approval.

Can I clone a missing Codex configuration repository automatically?

Yes, you can clone a missing Codex configuration repository automatically. The Skill detects if the local checkout is absent and safely clones the repository to establish your baseline configuration.

Why does my git pull fail when I have modified configuration files?

Your git pull fails on modified configuration files because this Skill enforces clean-worktree checks to preserve uncommitted changes. It stops the fast-forward and reports dirty files rather than silently overwriting them.