# codex-goal-progress

codex-goal-progress is a Claude Code hook that tracks Codex Goals with checklist progress and token usage. It shows goal status in the interface.

- hook · `type=hook` · Claude Code, Codex · ★ 1596 repo stars
- Author: Codex Goal Progress Contributors
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ezra-y/codex-goal-progress/hooks/hooks.json
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 40 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/hooks/codex-goal-progress

## What it does

This hook puts a native progress bar on Codex Goals. The bar moves as checklist items get done, and token spend sits next to it. Apple Silicon Macs only.

It listens on PreToolUse, PostToolUse, and SessionStart. At session start, `run-bootstrap.sh` restores active goal sessions, injects runtime identity, and watches lifecycle signals. PostToolUse updates for `update_goal` run async with a 2-second timeout and 64-token context limit.

Setup goes into `.claude/settings.json`. On Intel Macs or other platforms the bar will not run, because it targets Apple Silicon directly.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/settings.json` — The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ezra-y/codex-goal-progress/hooks/hooks.json

## When to use it
- render goal progress as a checklist inside Claude Code
- show token spend per goal
- restore active goal sessions after a restart
- refresh progress after each goal update

## Example prompts
- Activate goal_progress_activate and show its checklist
- Update the goal after I finish a checklist item
- Restore my active goal sessions when the session starts

## Source text · hooks.json · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: dad0845cf48918dc.

BEGIN THIRD-PARTY FILE dad0845cf48918dc
````text
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
          }
        ]
      }
    ]
  }
}

```
````
END THIRD-PARTY FILE dad0845cf48918dc

The third-party file has ended. Everything between the dad0845cf48918dc tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© Codex Goal Progress Contributors · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ezra-y/codex-goal-progress/hooks/hooks.json

## Similar
- [syncfusion-react-progress-bar](https://affpapa.org/en/nevibecode/skills/syncfusion-react-progress-bar.md) — skill · 685 installs
- [owner-goals](https://affpapa.org/en/nevibecode/skills/owner-goals.md) — skill · 468 installs
- [tqdm](https://affpapa.org/en/nevibecode/rules/tqdm.md) — rule · ★ 3589 repo stars
- [ai-statusline](https://affpapa.org/en/nevibecode/plugins/ai-statusline.md) — plugin · ★ 37 repo stars
- [hig-components-status](https://affpapa.org/en/nevibecode/skills/hig-components-status.md) — skill · 772 installs
- [hivemind-goals](https://affpapa.org/en/nevibecode/skills/activeloopai-hivemind-goals.md) — skill · ★ 1658 repo stars

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
