Skip to main content
subagent CX Codex

agent_unarchive — Claude Code subagent: what it does, how to install

The agent_unarchive Claude Code subagent returns an archived coding-agent session to the Agents list. It also asks the agent’s own tool to restore the session where it was archived.

MIT ★ 395 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/agent_unarchive.md
Open on GitHub

What agent_unarchive does

The subagent puts an archived session back in the Agents list. It needs the machine name or ID shown by agents_list, plus the session ID; the first 8 characters of that ID can be used instead.

Restoring the list entry does not restart a stopped agent. Resume it separately with agent_send and the resume parameter. Persona also calls the agent’s own tool to restore the session there and reports whether that worked.

What it helps with

  • return an archived session to the Agents list
  • locate a session using its machine and session IDs
  • restore a session in the tool that archived it
  • distinguish restoring a session from restarting a stopped agent

Example prompts for the agent

  • Return session a1b2c3d4e5 on machine build-01 to the Agents list.
  • Restore archived session a1b2c3d4 on machine devbox.
  • Add agent session a1b2c3d4 from build-01 back to Agents.

How to install agent_unarchive

Manually: put the files in place

.claude/agents/agent_unarchive.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about agent_unarchive

How do I install agent_unarchive in Claude Code?

Add the subagent file to the project at .claude/agents/agent_unarchive.md.

What does agent_unarchive do?

It returns an archived coding-agent session to the Agents list and asks the agent’s own tool to restore it where it was archived. This does not resume a stopped agent.

What information does agent_unarchive need to find a session?

It needs the machine name or ID shown by agents_list and the session ID. The first 8 characters of the session ID are accepted.

Source text

agent_unarchive.md · MIT
Bring an archived coding agent's session back into the Agents list (find it with agents_list and state archived). Nothing is reopened on the computer: a stopped agent stays stopped until resumed (agent_send with resume). Persona also asks the agent's own tool to restore it where that tool archived it too; the result says whether it did.

```json
{
  "type": "object",
  "required": ["machine", "session_id"],
  "properties": {
    "machine": {
      "type": "string",
      "description": "the machine's id or name, as agents_list shows it"
    },
    "session_id": {
      "type": "string",
      "description": "the agent's session id, or its first 8 characters"
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set61

The whole set →
room_claude The room_claude prompt for Claude Code sets up an assistant for a recorded meeting. It tracks topics and key points, answers from meeting material, and handles photos sent during the meeting. GP ChatGPT ★ 395repo stars instructions The instructions prompt for Claude Code and ChatGPT sets rules for Persona’s voice assistant. It routes requests to the right conversation and guides when to answer, search, or hand off work. GP ChatGPT ★ 395repo stars supervision_instructions supervision_instructions is a Claude Code prompt for supervising agent tasks and checking their results. It defines how to track assignments, respond to status signals, and decide whether work is ready to accept. GP ChatGPT ★ 395repo stars task_continuation The task_continuation subagent for Claude Code resumes work on an existing to-do. It keeps the original brief, decisions, and history on that task instead of opening a separate follow-up. CX Codex ★ 395repo stars task_start_screen The task_start_screen Claude Code subagent reads the last lines of a task’s terminal tab when its agent failed to start. It shows a shell prompt waiting for input or the point where the agent’s screen stopped. CX Codex ★ 395repo stars dispatch_task The dispatch_task Claude Code subagent takes work from another coding agent and handles it itself. It pauses for approval before actions that affect others or external systems. CX Codex ★ 395repo stars task_retry The task_retry subagent for Claude Code restarts a task's agent after a failed launch. It reuses the existing tab when possible, or opens a new one. CX Codex ★ 395repo stars agent_read This Claude Code subagent reads a selected agent’s recent conversation. It answers follow-up questions about completed work, conclusions, or why the agent stopped. CX Codex ★ 395repo stars

Project sponsors

Companies that keep this analytics open