К основному содержанию
субагент CX Codex

agent_archive — субагент для Claude Code: что делает и как установить

Субагент agent_archive для Claude Code переносит сессию кодинг-агента из активного списка в архив. Срабатывает по запросу на наведение порядка или архивацию сессий.

MIT ★ 395 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/agent_archive.md
Открыть на GitHub

Что делает agent_archive

Субагент перемещает сессию из agents_list в раздел архива, ничего не удаляя с диска. Для возврата сессии используется agent_unarchive. Если инструмент агента поддерживает встроенный архив (например, Codex), субагент запрашивает архивацию у него и возвращает статус операции: done, pending или unsupported.

Для вызова требуются параметры machine и session_id. Флаг close по умолчанию выключен. При его активации субагент закрывает процесс и вкладку терминала на целевом компьютере, предварительно запросив подтверждение через телефон. Занятого агента архивировать нельзя: если сессия выполняет код, ждёт фоновую задачу, крутит цикл /loop или держит открытый порт, запрос отклоняется.

Флаг force: true позволяет принудительно отменить и закрыть агента, который застрял в ожидании подтверждения в терминале. Не работает для обычных диалогов Persona — для них предназначен conversation_archive.

Какие задачи решает

  • перенести завершённую сессию кодинг-агента в архив
  • закрыть зависший на подтверждении терминала процесс с флагом force
  • остановить агентский процесс и закрыть вкладку терминала на машине
  • проверить статус нативной архивации сессии в Codex

Примеры запросов агенту

  • Архивируй сессию a1b2c3d4 на машине dev-box
  • Убери в архив сессию 98765432 и закрой её терминал на рабочем компьютере
  • Принудительно останови и заархивируй зависшего агента e5f6a7b8 на сервере mac-mini

Как установить agent_archive

Вручную: положить файлы

.claude/agents/agent_archive.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об agent_archive

Как установить agent_archive в Claude Code?

Добавьте файл конфигурации по пути .claude/agents/agent_archive.md.

Что делает agent_archive?

Субагент убирает сессию агента из активного списка в архив без удаления стенограммы. При передаче флага close он также останавливает сессию и закрывает вкладку терминала.

Что произойдёт, если агент выполняет задачу в момент вызова?

Запрос на архивацию будет отклонён. Субагент не трогает агентов, которые работают, ждут ответ, держат очереди сообщений, циклы /loop или активные порты.

Исходный текст

agent_archive.md · MIT
Archive a coding agent's session (from agents_list) when the user asks to archive or tidy up agents: it leaves the Agents list for Archived in the app, nothing is deleted, and agent_unarchive brings it back (never remove a session any other way). Persona also asks the agent's own tool to archive it where that tool has an archive (Codex); the result says whether it did (native: done / pending / unsupported). Without close the agent itself is not closed: one open on its computer stays open. With close, its agent and its terminal tab are also closed on its computer (its transcript stays; then it is stopped until resumed): only when the user asks to close it too, and the user confirms on the phone first (declined: nothing changes). A busy agent is refused and nothing changes: working, waiting for an answer or background work, and for close also a /loop, queued messages or a server it runs. When the close does not happen the session stays archived and still open on the computer, and the result says why: tell the user exactly that, not that it was closed. With `force: true`, explicitly cancel and close an Agent stuck waiting for a terminal confirmation, then archive it, as `paseo archive --force` does. Use force only when the user asks to stop or archive that blocked Agent. Pending permissions and plans are rejected or cancelled, never allowed. Working Agents, background work, running subagents/workflows, queued messages, loops and serving ports are still refused. A failed close leaves it visible. Force implies close and does not ask for a second permission card. Not for Persona conversations (conversation_archive).

```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"
    },
    "force": {
      "type": "boolean",
      "description": "cancel and close a confirmation-blocked Agent before archiving; only when the user asks; never approve its pending request"
    },
    "close": {
      "type": "boolean",
      "description": "also close its agent on the computer (asks the user on the phone first); default false: archive only"
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
recipe-label-and-archive-emails официальный googleworkspace Скилл recipe-label-and-archive-emails для Claude Code организует почту: ищет письма в Gmail по условию, добавляет метки и архивирует их через Google Workspace CLI. CX Codex +1 31 500установок openspec-archive-change openspec Скилл openspec-archive-change архивирует выполненные изменения спецификаций в экспериментальном цикле OpenSpec. Он проверяет готовность артефактов и задач перед фиксацией результата. CX Codex +1 4 500установок archive ReScienceLab Скилл archive сохраняет решения сложных багов, шаги деплоя и выводы сессий в локальные markdown-файлы. Ведёт единый индекс памяти проекта между перезапусками агента. CX Codex +1 1 200установок todo-archive PaulRBerg Скилл todo-archive переносит выполненные задачи из .ai/TODO.md в ежедневные архивы. Оставляет незакрытые пункты на месте. CX Codex +1 130установок archive-conversation nweii Скилл archive-conversation для Claude Code архивирует разговор с ИИ: фиксирует решения, ход мысли и открытые вопросы. Создаёт заметку, к которой можно вернуться без исходного диалога. CX Codex +1 117установок bmad-agent-pm bmad-code-org Скилл bmad-agent-pm включает субагента Джона для сбора требований к продукту и подготовки PRD. Помогает перевести идеи в понятные разработчикам задачи. CX Codex +1 17 800установок

Из того же набора61

Весь набор →
agent_supervise Субагент agent_supervise для Claude Code берёт под контроль уже запущенного агента и связывает его работу с задачей текущего разговора. Он получает сообщения о ходе работы, а завершённую задачу закрывает через task_review. CX Codex ★ 395звёзд репо task_decided Субагент task_decided для Claude Code фиксирует ответ владельца на ожидающее решение по задаче. Он записывает выбранный вариант, когда владелец сообщил его в разговоре. CX Codex ★ 395звёзд репо agents_list Субагент agents_list для Claude Code и Codex собирает статусы запущенных сессий herdr. Показывает активные задачи, зависшие аппрувы и лимиты подписок. CX Codex ★ 395звёзд репо task_scope Субагент task_scope для Claude Code меняет цель контролируемой задачи после её запуска. Он обновляет критерии завершения и срок, а владелец видит изменение в следующем дайджесте. CX Codex ★ 395звёзд репо agent_switch Субагент agent_switch для Claude Code переносит работающего агента в другой лаунчер на том же компьютере. Он переключает сессию только по просьбе пользователя. CX Codex ★ 395звёзд репо worker_supervise Субагент worker_supervise для Claude Code управляет запущенными через task_plan воркерами и разбирает их статусы. Он сверяет результаты с критериями готовности и передаёт решения через task_review. CX Codex ★ 395звёзд репо agents_switch Субагент agents_switch для Claude Code переносит запущенных и остановленных агентов на другой лаунчер за один вызов. Срабатывает по запросу пользователя при контроле лимитов подписки. CX Codex ★ 395звёзд репо standing_actions Субагент standing_actions для Claude Code классифицирует действия, которые разрешает карта подтверждения агента. CX Codex ★ 395звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой