# Add Agent Hooks Open Code

> Add agent-hooks plugin for Open Code containers. Sends tool execution and session start notifications to chat channels. Triggers on "add open code hooks", "enable open code hooks", "setup open code hooks".

- Skill: `yukihirop/add-agent-hooks-open-code` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yukihirop/add-agent-hooks-open-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yukihirop/add-agent-hooks-open-code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yukihirop (https://skillmd.com/u/yukihirop)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yukihirop/add-agent-hooks-open-code

---


# Add Agent Hooks (Open Code)

## Step 0: Language selection

Before proceeding with any other steps in this skill, ask the user which language to continue in using `AskUserQuestion`. Keep this initial prompt in English because the preferred language is not yet known.

- Question: `Which language should I continue in?`
- Options: `English`, `日本語 (Japanese)`

Use the selected language for all subsequent user-facing messages and for every further `AskUserQuestion` prompt in this skill. Do not translate code, file paths, shell commands, or file contents.

Enable PostToolUse and SessionStart hooks for Open Code containers that send real-time notifications to the chat channel.

## What it does

- **PostToolUse** — Sends a message like `` 🔧 `Bash: ls -la /workspace/group` `` to the chat channel after each tool execution
- **SessionStart** — Sends `💭 Thinking...` when a new session begins

## Steps

### 1. Check prerequisites

```bash
test -f deploy/{ASSISTANT_NAME}/host/entry.ts && echo "ENTRY_EXISTS" || echo "ENTRY_MISSING"
test -f deploy/templates/container/open-code/entry.template.ts && echo "TEMPLATE_EXISTS" || echo "TEMPLATE_MISSING"
```

If `deploy/{ASSISTANT_NAME}/host/entry.ts` is missing, run `/setup` first.

### 2. Create agent-hooks plugin for Open Code

Check if plugin already exists:
```bash
test -d container/open-code/plugins/agent-hooks && echo "EXISTS" || echo "MISSING"
```

If missing, copy from Claude Code's plugin (they share the same IPC-based logic):
```bash
mkdir -p container/open-code/plugins/agent-hooks
cp container/claude-code/plugins/agent-hooks/index.mjs container/open-code/plugins/agent-hooks/index.mjs
```

### 3. Enable hooks in deploy/{ASSISTANT_NAME}/host/entry.ts (host side)

Read `deploy/{ASSISTANT_NAME}/host/entry.ts` and check if `registerHooksPlugin` is already called.

If not present, add after the MCP plugin registrations:

```typescript
// Register agent hooks (PostToolUse / SessionStart notifications to chat)
orchestrator.registerHooksPlugin({
  postToolUse: true,
  sessionStart: true,
});
```

### 4. Enable hooks in deploy/templates/container/open-code/entry.template.ts (container side)

Read `deploy/templates/container/open-code/entry.template.ts` and check if the `agent-hooks` plugin is loaded.

If not present, ensure the plugin import block exists:

```typescript
try {
  const pluginPath = "/app/agent-plugins/agent-hooks/index.mjs";
  const agentHooks = await import(/* webpackIgnore: true */ pluginPath);

  plugins.push({
    name: "agent-hooks",
    createHooks: (
      chatJid: string,
      groupFolder: string,
      hooksConfig: { postToolUse?: boolean; sessionStart?: boolean; skipTools?: string[] } | undefined,
      log: (msg: string) => void,
    ) => ({
      ...(hooksConfig?.postToolUse !== false ? {
        PostToolUse: [{ hooks: [agentHooks.createPostToolUseHook(chatJid, groupFolder, hooksConfig?.skipTools, log)] }],
      } : {}),
      ...(hooksConfig?.sessionStart !== false ? {
        SessionStart: [{ hooks: [agentHooks.createSessionStartHook(chatJid, groupFolder, log)] }],
      } : {}),
    }),
  });
} catch {
  // Plugin not available, skip
}
```

### 5. Sync local entry.ts

```bash
cp deploy/templates/container/open-code/entry.template.ts deploy/{ASSISTANT_NAME}/container/open-code/entry.ts
```

Or run `/deploy` and select Open Code.

### 6. Rebuild and restart

```bash
./container/open-code/build.sh
launchctl kickstart -k gui/$(id -u)/com.nagi.{ASSISTANT_NAME}
sleep 2
launchctl list | grep com.nagi.{ASSISTANT_NAME}
```

### 7. Test

Tell user to send a message in Slack/Discord that triggers tool use.

Expected: tool execution notifications appear in the chat channel.