codex-goal-progress — хук для Claude Code: прогресс-бар целей и токены
Хук codex-goal-progress для Claude Code показывает прогресс целей Codex по чеклистам и расход токенов. Состояние видно прямо в интерфейсе при работе с Codex Goals.
MIT ★ 1 596 обновлён 2026-10-29
.claude/settings.jsonЧто делает codex-goal-progress
Хук рисует нативный прогресс-бар для целей Codex. Прогресс считается по чеклисту: выполненные пункты двигают полосу, рядом отображается расход токенов. Работает на Apple Silicon Mac.
Срабатывает на три события: PreToolUse, PostToolUse и SessionStart. При старте сессии скрипт run-bootstrap.sh восстанавливает активные сессии целей, внедряет идентичность рантайма и слушает сигналы жизненного цикла. Обновление цели в PostToolUse выполняется асинхронно, с таймаутом 2 секунды и лимитом контекста 64.
Для установки нужно положить конфигурацию в .claude/settings.json. Работает только на Mac с Apple Silicon — на Intel-маках и других платформах прогресс-бар не запустится.
Какие задачи решает
- показать прогресс цели чеклистом внутри Claude Code
- увидеть расход токенов по каждой цели
- восстановить активные сессии целей после перезапуска
- получать обновления прогресса после каждого изменения цели
Примеры запросов агенту
- Активируй цель goal_progress_activate и покажи её чеклист
- Обнови прогресс по цели update_goal после выполнения пункта
- Верни активные сессии целей при запуске сессии
Как установить codex-goal-progress
Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о codex-goal-progress
Как установить codex-goal-progress в Claude Code?
Добавьте конфигурацию хуков в файл .claude/settings.json. После этого хук подхватится при следующем старте сессии.
Что делает codex-goal-progress?
Рисует прогресс-бар для целей Codex. Прогресс зависит от чеклиста, а рядом показывается использование токенов.
Почему хук работает только на Apple Silicon?
Нативный прогресс-бар завязан на Apple Silicon Mac. На Intel-маках и других платформах он не запустится.
Исходный текст
hooks.json · MIT
Hooks bundle shipped with the codex-goal-progress plugin for Claude Code.
A native progress bar for Codex Goals with checklist-based progress and token usage on Apple Silicon Macs.
Triggers on: PreToolUse, PostToolUse, SessionStart.
```json
{
"description": "Restore active Goal Progress sessions, inject runtime identity, and observe bounded lifecycle signals.",
"hooks": {
"SessionStart": [
{
"matcher": "^(?:startup|resume|compact)$",
"hooks": [
{
"type": "command",
"command": "/bin/sh \"$PLUGIN_ROOT/runtime/run-bootstrap.sh\" hook",
"timeout": 3,
"additionalContextLimit": 128
}
]
}
],
"PreToolUse": [
{
"matcher": "^(?:goal_progress_|.*[^A-Za-z0-9]goal_progress[^A-Za-z0-9]+goal_progress_)(?:activate|initialize|get|update|rescope|set_phase)$",
"hooks": [
{
"type": "command",
"command": "/bin/sh \"$PLUGIN_ROOT/runtime/run-bootstrap.sh\" hook",
"timeout": 1
}
]
}
],
"PostToolUse": [
{
"matcher": "^update_goal$",
"hooks": [
{
"type": "command",
"command": "/bin/sh \"$PLUGIN_ROOT/runtime/run-bootstrap.sh\" hook",
"timeout": 2,
"async": true,
"additionalContextLimit": 64
}
]
}
]
}
}
```
© Codex Goal Progress Contributors · MIT · hashgraph-online/awesome-codex-plugins