codex-history-sync SKILL.md skillA
codex-history-sync from black-yt/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add black-yt/skills/codex-history-sync@git:20260701.f15c195Pins git:20260701.f15c195 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- black-yt/skills
- Path
codex-history-sync/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260701.f15c195, committed Jul 1, 2026
- First version recorded
- Jun 12, 2026
- Size
- 9,715 bytes
- Repository stars
- 16
- License
- none declared
当需要把一个 CODEX_HOME/.codex 中的 Codex 会话记录、history.jsonl、sessions 和 thread title 元数据单向同步到另一个用户或目录下的 .codex 时使用；强调 dry-run、敏感配置排除、filter、force 边界和同步后验证。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Codex History Sync ## 适用场景 - 把一个 `CODEX_HOME` 下的 `.codex` 历史记录同步给另一个用户、另一台机器、另一个 Windows/WSL 目录或备份目录。 - 只迁移会话记录、`history.jsonl`、`sessions/` 和 thread title/name 元数据，不迁移登录态和长期配置。 - 需要按项目关键词筛选历史记录时，用 `--filter` 做路径/文本内容正则过滤。 - 需要只同步会话标题、名称或 SQLite/JSON/JSONL 中的 title metadata 时，用 `--rename-only`。 ## 核心边界 - 这是单向同步：`--source` 是可信来源，`--dest` 是接收方。 - 默认不会删除目标目录中的文件。 - 默认不会覆盖目标中已有但内容不同的文件；只有加 `--force` 才会覆盖。 - 默认排除 `auth.json`、`config.toml`、`credentials.json`、`settings.json`、`.env`，以及 `bin/`、`cache/`、`logs/`、`node_modules/`、`tmp/`。 - 不要默认使用 `--include-sensitive`。只有用户明确要求迁移配置/凭据类文件，并理解风险时才考虑。 - 同步前先运行 `--dry-run --verbose`，确认复制、覆盖、跳过和 title 更新范围。 ## 脚本 使用 bundled script： ```bash python3 codex-history-sync/scripts/sync_codex_history.py --help ``` 脚本能力： - 复制源 `.codex` 中选定目录和根文件，默认同步 `sessions/` 和 `history.jsonl`。 - 保留相对路径和文件时间戳。 - 对已有不同文件默认跳过，避免覆盖目标用户已有历史。 - 支持 `--force` 覆盖目标不同文件。 - 支持 `--filter '[REGEX]'`，只同步相对路径或文本内容匹配的记录。 - 支持 `--all-folders` 或 `--folders sessions [OTHER_FOLDER]` 控制顶层目录。 - 支持 `--root-files history.jsonl [OTHER_FILE]` 控制根文件。 - 支持从 JSON、JSONL 和 SQLite 文件中收集源 thread title/name，并更新目标中的同 ID title/name。 ## 推荐流程 1. 确认源和目标目录。 ```bash …
Read the whole file at its exact version.
How to install
mdr add black-yt/skills/codex-history-sync@sha256:45fb6a56e86b02d2The line at the top of this page pins the label git:20260701.f15c195, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_w6ty6i4tztk6da6d)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jun 12, 2026 and Jul 1, 2026, about one every 19 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260701.f15c195 latest | 2026-07-01 | f15c195 | 9,715 B | A | view · diff |
| git:20260612.5cd8b04 | 2026-06-12 | 5cd8b04 | 6,869 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9715 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
black-yt/skills · 16 stars · license none declared · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_w6ty6i4tztk6da6d GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/codex-history-sync GET https://markdownregistry.com/api/v1/blob/45fb6a56e86b02d2ed59030747e480f4f53a68b980f40c93cc3d36a4299dc43f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.