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
.claude/settings.jsonWhat 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.jsonThe 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