Skip to main content
hook CX Codex

homie — Claude Code hook: what it does and setup

homie checks tool calls, pauses risky actions for approval, and removes secrets from results the model reads.

Apache-2.0 ★ 1,596 updated 2026-10-29

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What homie does

homie includes hooks for Claude Code and Codex. They run before and after tool calls, as well as when a prompt is submitted. The Codex setup invokes hooks/codex.mjs, with decision checks in lib/holds.mjs.

Certain edits, production deploys, and paid calls can pause until a person enters proceed <code>. Some operations are blocked outright, including committing a file over 5 MB from games/ and a Stripe write that would expose a webhook secret. Secrets are also stripped from tool results read by the model.

A paid call whose cost cannot be checked first needs approval. In Claude Code, add the hook settings to .claude/settings.json.

What it helps with

  • Require approval before a production deploy
  • Block a Stripe write that exposes a webhook secret
  • Stop oversized files from entering games/ through git
  • Remove secrets from tool results

Example prompts for the agent

  • Deploy the studio to production, but ask me to approve it first.
  • Check whether this file exceeds 5 MB before committing it from games/.

How to install homie

Manually: put the files in place

.claude/settings.json

The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command

Questions about homie

How do I install homie in Claude Code?

Add the hook settings to .claude/settings.json.

What does homie do?

It checks tool actions, pauses some risky operations, and strips secrets from results the model reads.

Does homie work with Codex?

Yes. Its Codex handler is hooks/codex.mjs, which uses the decision checks in lib/holds.mjs.

Source text

codex.json · Apache-2.0
Hooks bundle shipped with the homie plugin for Claude Code.

Makes and remixes multiplayer web games, music and video, then publishes them from a studio site with public rooms on your own Cloudflare account.

Triggers on: PreToolUse, PostToolUse, UserPromptSubmit.

```json
{
  "description": "Homie's holds in Codex (hooks/codex.mjs, deciding with lib/holds.mjs, the module the Claude Code mod asks): an edit to a file the studio protects, a production deploy, a change to the studio's Cloudflare account outside its deploy and a paid call past the budget or whose cost cannot be read first wait for the person's own \"proceed <code>\"; a change to a locked art decision, an unlicensed asset in a public game's deploy, a file over 5 MB under games/ into git and a Stripe write that would hand back a webhook secret are refused; and secrets come out of every tool result the model reads.",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "^(Bash|apply_patch|mcp__.+)$",
        "hooks": [
          { "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" pre", "timeout": 90, "statusMessage": "Homie: checking this call" }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          { "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" prompt", "timeout": 10 }
        ]
      }
    ],
    "PostToolUse": [
      {
        "hooks": [
          { "type": "command", "command": "node \"${PLUGIN_ROOT}/hooks/codex.mjs\" post", "timeout": 30 }
        ]
      }
    ]
  }
}

```

© Homie · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Similar hooks

Hooks catalog →

From the same set391

The whole set →

Project sponsors

Companies that keep this analytics open