maestro — хук для Claude Code: перехват Bash и вызовов субагентов
Хук maestro для Claude Code запускает обработчики при старте и завершении сессии, перед вызовом субагента и Bash. Он подключает эти проверки к работе Claude Code.
Apache-2.0 ★ 489 обновлён 2026-10-26
/plugin marketplace add josstei/maestro-orchestrate
/plugin install maestro@maestro-orchestratorЧто делает maestro
Хук входит в плагин maestro и реагирует на события SessionStart, SessionEnd и PreToolUse. Перед запуском субагента вызывается hook-runner.js с аргументом before-agent, а перед использованием Bash — policy-enforcer.js. Обработчики сессии запускают тот же runner с аргументами session-start и session-end.
Скрипты запускаются через node из ${CLAUDE_PLUGIN_ROOT}/scripts/. Для запуска обработчика Bash задан тайм-аут 5, для остальных команд — 10. Это значит, что правила из policy-enforcer.js могут вмешаться в вызовы Bash; учитывайте это, если проект полагается на такие команды.
Какие задачи решает
- запускать обработчик при начале сессии
- сохранять действия при завершении сессии
- перехватывать вызов субагента до его запуска
- проверять вызовы
Bashчерезpolicy-enforcer.js
Примеры запросов агенту
- Передай задачу субагенту и проверь, что срабатывает обработчик перед его запуском.
- Запусти нужную команду через
Bash, чтобы проверить хук для вызовов оболочки. - Заверши сессию и проверь запуск обработчика
session-end.
Как установить maestro
1Через маркетплейс плагинов
/plugin marketplace add josstei/maestro-orchestrate/plugin install maestro@maestro-orchestrator2Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о maestro
Как установить maestro в Claude Code?
В Claude Code выполни /plugin marketplace add josstei/maestro-orchestrate и затем /plugin install maestro@maestro-orchestrator. Настройки плагина находятся в .claude/settings.json.
Что делает maestro?
Хук запускает скрипты при старте и завершении сессии, перед вызовом субагента и перед использованием Bash.
Какие события запускают хук maestro?
Он реагирует на SessionStart, SessionEnd и PreToolUse. Для последнего настроены обработчики вызова Agent и Bash.
Исходный текст
claude-hooks.json · Apache-2.0
Hooks bundle shipped with the maestro plugin for Claude Code.
Multi-agent development orchestration platform — 39 specialists, 4-phase orchestration, native parallel subagents, persistent sessions, and standalone review/debug/security/perf/seo/a11y/compliance commands
Triggers on: PreToolUse, SessionStart, SessionEnd.
```json
{
"hooks": {
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/hook-runner.js claude session-end",
"timeout": 10
}
]
}
],
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/hook-runner.js claude session-start",
"timeout": 10
}
]
}
],
"PreToolUse": [
{
"hooks": [
{
"type": "command",
"command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/hook-runner.js claude before-agent",
"timeout": 10
}
],
"matcher": "Agent"
},
{
"hooks": [
{
"type": "command",
"command": "node ${CLAUDE_PLUGIN_ROOT}/scripts/policy-enforcer.js",
"timeout": 5
}
],
"matcher": "Bash"
}
]
}
}
```
© josstei · Apache-2.0 · josstei/maestro-orchestrate