Home / sidiangongyuan / codex-skills-library · skills/codex-session-restore/SKILL.md · GitHub

codex-session-restore skillA

codex-session-restore is agent-read markdown (skill) from sidiangongyuan/codex-skills-library: Use when Codex Desktop sidebar sessions disappear, fail with systemError, or cannot continue after a model_provider switch. Diagnoses and repairs active, non-archived sessions without changing authentication or provider configuration..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Codex Session Restore

Use the bundled script first. It is dry-run by default and writes nothing unless
`--apply` is present.

## Provider Direction Rule

Set `--provider` to the provider that Codex Desktop should recognize now, not
automatically to the provider that originally created the sessions.

- If the user switched from krill/custom to official OAuth and wants old active
  sessions to appear under the current official login, use `--provider openai`.
- If the user explicitly wants to switch the environment back to krill and make
  sessions belong to krill, use `--provider krill`.
- Do not edit `config.toml`, `auth.json`, or cc-switch's current provider just
  to restore sidebar visibility. Changing current auth/provider is a separate
  user request.

## Quick Start

Resolve `<skill-dir>` to the directory containing this `SKILL.md`; do not
assume a particular global skills installation root.

Restore old krill sessions into the current official/OAuth sidebar:

```powershell
python "<skill-dir>/scripts/restore_codex_sessions.py" scan --provider openai
python "<skill-dir>/scripts/restore_codex_sessions.py" repair-active --provider openai
…

Read the whole file at its exact version.

How to install

Latest version
mdr add sidiangongyuan/codex-skills-library/codex-session-restore@git:20260712.ef71354
Exact content
mdr add sidiangongyuan/codex-skills-library/codex-session-restore@sha256:4134188998439e77

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_k2jvu3insfxekrkj.svg)](https://markdownregistry.com/a/art_k2jvu3insfxekrkj)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260712.ef71354 latest2026-07-12 ef71354 6,449 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6449 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

GitHub

sidiangongyuan/codex-skills-library · 9 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_k2jvu3insfxekrkj
GET https://markdownregistry.com/api/v1/resolve?ref=sidiangongyuan/codex-skills-library/codex-session-restore
GET https://markdownregistry.com/api/v1/blob/4134188998439e772eeb1087479590a89640f8ae4a72b25e47a10abbcb9631ce

Your agent 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.

More from sidiangongyuan/codex-skills-library

app-bug-forensics skill
sidiangongyuan/codex-skills-library · skills/app-bug-forensics/SKILL.md · Use when diagnosing or fixing user-reported application bugs. Guides evidence-backed root-cause analysis from symptoms…
git:20260712.ef71354 · audit A · 9 stars
app-feature-craft skill
sidiangongyuan/codex-skills-library · skills/app-feature-craft/SKILL.md · Use when implementing or improving a user-facing app workflow. Guides product-grade UX, frontend, backend/API behavior…
git:20260712.ef71354 · audit A · 9 stars
app-release-readiness skill
sidiangongyuan/codex-skills-library · skills/app-release-readiness/SKILL.md · Use when preparing a desktop or web app update for commit, packaging, installer validation, GitHub publication, release…
git:20260712.ef71354 · audit A · 9 stars
design-taste-frontend skill
sidiangongyuan/codex-skills-library · skills/design-taste-frontend/SKILL.md · Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right…
git:20260728.202a6de · audit B · 9 stars
experiment-planner skill
sidiangongyuan/codex-skills-library · skills/experiment-planner/SKILL.md · Use when exploring, continuing, or accepting a deep-learning or computer-science research idea. Converts claims into…
git:20260914.b6933d0 · audit A · 9 stars
feishu-paper-reading skill
sidiangongyuan/codex-skills-library · skills/feishu-paper-reading/SKILL.md · Search, screen, deeply read, synthesize, and publish recent research papers for a user-specified topic, window, count…
git:20260822.07d2485 · audit A · 9 stars
github-project-release skill
sidiangongyuan/codex-skills-library · skills/github-project-release/SKILL.md · Use when preparing or publishing a local project as a clean GitHub repository. Covers new repositories, private staging…
git:20260712.ef71354 · audit A · 9 stars
grill-me skill
sidiangongyuan/codex-skills-library · skills/grill-me/SKILL.md · Use when a user asks for or clearly wants to be grilled, interviewed, or to stress-test a plan or design, including…
git:20260905.1cfe2a2 · audit A · 9 stars
paper-framework-figure-studio-pro skill
sidiangongyuan/codex-skills-library · skills/paper-framework-figure-studio-pro/SKILL.md · Use when planning a source-grounded method overview, architecture, pipeline, system/data-flow, mechanism, or…
git:20260712.ef71354 · audit A · 9 stars
paper-review-panel skill
sidiangongyuan/codex-skills-library · skills/paper-review-panel/SKILL.md · Use when independently reviewing a research-paper draft before submission, running a mock top-conference panel…
git:20260727.8247c94 · audit A · 9 stars
paper-share-html skill
sidiangongyuan/codex-skills-library · skills/paper-share-html/SKILL.md · Create or revise audience-ready HTML paper presentations for lab meetings and journal clubs. Use when Codex needs…
git:20260921.41f5a21 · audit A · 9 stars
paper-visual-craft skill
sidiangongyuan/codex-skills-library · skills/paper-visual-craft/SKILL.md · Use when designing, redrawing, or validating research-paper figures and tables, including Matplotlib plots, LaTeX…
git:20260921.41f5a21 · audit A · 9 stars

Every file in sidiangongyuan/codex-skills-library

Browse by kind, by grade A, or by owner.