Skip to content

akarachen/resume

v0.1.0Apache-2.0

Resume work from a recent Claude Code, Codex, or Cursor session. Shared reader runtime plus per-tool aliases.

English · 中文

agent-plugin-resume

You switched coding agents. The other session is still on disk. This plugin lets the current agent pick it up and keep going.

Point it at a recent Claude Code, Codex, or Cursor session — by “latest”, a few words, or an id. It writes a short handoff of where that work left off, checks it against the repo in front of you, then continues with this agent’s tools. The old transcript is not pasted in, and it is not treated as instructions.

Skills

When you want to…Use
Continue from another agent, and you may not remember whichresume-other-agent
Continue a Claude Code sessionresume-claude
Continue a Codex sessionresume-codex
Continue a Cursor sessionresume-cursor

Install

This repo is an Agent Plugin marketplace. The plugin is named resume.

Claude Code

claude plugin marketplace add AkaraChen/agent-plugin-resume
claude plugin install resume@agent-plugin-resume

Codex

codex plugin marketplace add AkaraChen/agent-plugin-resume
codex plugin add resume@agent-plugin-resume

Cursor

# from a trusted checkout
cursor-agent --plugin-dir /path/to/agent-plugin-resume

Hosts that load Agent Skills from disk can copy the four folders under skills/. Keep all four together.

Use

/resume-other-agent cursor the auth refactor
/resume-codex latest
/resume-claude
/resume-cursor 0193f0c2-…
  • No argument, empty, or latest → newest session for the current working directory.
  • A native session id or transcript path is accepted as-is.
  • Free text is matched against that tool’s session list. Ambiguous matches are shown, never guessed.

How it works

Coding agents do not share a session store. Pasting a transcript into a new window is noisy and unsafe. These skills read the foreign session as untrusted inert history: no replaying system prompts, tool calls, or thinking.

Then:

  1. Read the session.
  2. Summarize only what is needed to continue (not the recovered turns).
  3. Verify cwd, git state, named files, and stale tool output.
  4. Continue with this agent’s tools and policy.

The reader is Python 3 + the standard library.

resume-other-agent infers claude / codex / cursor from the prompt; if that is still unclear, it lists recent sessions and asks. The other three skills pin the tool. All four share one runtime, so they must stay siblings — installing a single alias is not enough.

  /resume-claude  ─┐
  /resume-codex   ─┼─►  shared reader
  /resume-cursor  ─┘
         ▲
  /resume-other-agent

Layout

plugin.json                         Agent Plugins 1.0.0 manifest
.claude-plugin/                     Claude Code plugin + marketplace
.codex-plugin/plugin.json           Codex plugin
.agents/plugins/marketplace.json    Cursor / Amp-style marketplace
skills/
  resume-other-agent/               generic entry + shared runtime
    references/resume-session/
      CORE.md
      session_reader.py
  resume-claude/                    alias
  resume-codex/                     alias
  resume-cursor/                    alias

Source

Copied from the Grok Build / grok CLI bundled platform skills, published by SpaceXAI (xAI).

CORE.md and session_reader.py are unchanged from that bundle. resume-other-agent/SKILL.md is the merged wrapper; the three aliases are the original shells with SHARED_DIR pointed at the shared runtime. Per-file hashes and the full adaptation note live in skills/resume-other-agent/README.md.

License: Apache-2.0, Copyright 2023-2026 SpaceXAI.