agents_list — субагент для Claude Code: что делает и как установить
Субагент agents_list для Claude Code и Codex собирает статусы запущенных сессий herdr. Показывает активные задачи, зависшие аппрувы и лимиты подписок.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/agents_list.mdЧто делает agents_list
Субагент запрашивает herdr и возвращает список процессов Claude Code и Codex на машинах пользователя. По умолчанию фильтр active объединяет статусы needs_you, working и unread. Каждая строка содержит имя машины, идентификатор сессии, проект, заголовок, время последнего обновления и последнюю реплику агента.
Под строкой агента выводятся вопросы с вариантами ответов и interaction_id для вызова interaction_answer, а также ожидающие подтверждения действия. Ответ содержит отметки launcher=, статус ultracode=on/off для Claude Code и флаг исчерпания лимитов usage_limit с временем сброса. В конце списка субагент выводит лаунчеры, провалившие последнюю проверку здоровья.
Какие задачи решает
- отследить зависшие сессии в ожидании ответа или аппрува
- найти упавшие лаунчеры после проверки здоровья
- отфильтровать агентов по статусу, проекту или машине
- проверить исчерпание лимитов подписки на лаунчерах
Примеры запросов агенту
- Покажи всех агентов в статусе needs_you
- Найди сессии на машине devbox по проекту persona
- Выведи список завершённых агентов за последние 24 часа
Как установить agents_list
Вручную: положить файлы
.claude/agents/agents_list.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/agents_list.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/agents_list.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об agents_list
Как установить agents_list в Claude Code?
Сохраните файл конфигурации субагента по пути .claude/agents/agents_list.md.
Что делает agents_list?
Опрашивает herdr и выводит сводку по сессиям Claude Code и Codex, включая вопросы пользователю, здоровье лаунчеров и лимиты подписок.
Что нужно для работы agents_list?
Утилита herdr на машинах пользователя и запущенные сессии агентов Claude Code или Codex.
Исходный текст
agents_list.md · MIT
The Claude Code / Codex agents running on the user's computers (herdr), with their state: needs_you (waiting for an answer / approval), working, unread (finished, result not looked at), idle. done lists work finished in the last 24 hours, and muted lists the muted agents that would otherwise appear in the live snapshot; both include the work conclusion when known. Each line has machine, session id, project, title, last update and the last thing the agent said. launcher= names the launcher an agent runs on when it is known, and usage_limit (with resets_at when the reset is known) marks one its subscription's usage limit stopped (agent_switch moves such an agent to another launcher when the user asks). Known Claude Code switch states appear as ultracode=on/off; an omitted state is unknown. ultracode=on means every substantive task runs a multi-agent dynamic workflow, independently of thinking effort. Let it finish and wait for workflow results without nudging it. Much faster and more accurate than ssh + herdr. At the end: the launchers that failed their last health check, by machine (agent_start and task_plan move off them).
A line under an agent is something waiting for the user: a question lists its options and the interaction id to answer it with (interaction_answer), an approval is the user's to give in the app.
```json
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": ["active", "needs_you", "working", "unread", "idle", "done", "muted", "archived", "all"],
"description": "default active = needs_you + working + unread; done = finished work in the last 24 hours; muted = muted agents in the live snapshot categories; archived: only the archived sessions (agent_unarchive restores them); the others leave archived ones out, all lists them marked archived"
},
"machine": {
"type": "string"
},
"query": {
"type": "string",
"description": "filter by title / project / directory"
}
}
}
```
© nwverse · MIT · nwverse/persona