Hook – AI Integration

Composants

Hook

Les hooks sont des configurations déterministes qui exécutent une commande, un prompt, un appel webhook, etc. lorsqu’un événement se déclenche pendant l’exécution de la session.

Les événements se déclenchent à divers moments : au démarrage d’une session (SessionStart), lorsqu’un utilisateur soumet une instruction (UserPromptSubmit), avant l’exécution d’un outil (PreToolUse), et bien d’autres cas (la diversité dépend de l’agent runtime utilisé).

Les cas d’usage typiques des hooks incluent la limitation d’accès aux fichiers, la protection contre les commandes destructrices, la télémétrie, le lint de code, ou même la sauvegarde et la restauration automatiques des souvenirs de session.

Format : Claude Code
Aussi lu par : Copilot (niveau dépôt uniquement)
Pour aller plus loin : events, matchers, actions

repository/
└── .claude/
    ├── settings.json
    └── settings.local.json
~/.claude/
└── settings.json
~/.claude/plugins/cache/<marketplace>/<plugin>/
└── hooks/
    └── hooks.json

{
    "hooks": {
        "PreToolUse": [
            {
                "matcher": "Bash",
                "hooks": [
                    {
                        "type": "command",
                        "command": ".claude/hooks/lint-check.sh",
                        "shell": "bash"
                    },
                    {
                        "type": "command",
                        "command": ".claude\\hooks\\lint-check.ps1",
                        "shell": "powershell"
                    }
                ]
            }
        ]
    }
}

Format : Codex
Pour aller plus loin : events, matchers, actions

repository/
└── .codex/
    └── hooks.json
~/.codex/
└── hooks.json
~/.codex/plugins/cache/<marketplace>/<plugin>/<version>/
└── hooks/
    └── hooks.json

{
    "hooks": {
        "PreToolUse": [
            {
                "matcher": "Bash",
                "hooks": [
                    {
                        "type": "command",
                        "command": ".codex/hooks/lint-check.sh",
                        "commandWindows": ".codex\\hooks\\lint-check.ps1"
                    }
                ]
            }
        ]
    }
}

Format : Copilot
Pour aller plus loin : events, matchers, actions

repository/
└── .github/
    ├── copilot/
    │   ├── settings.json
    │   └── settings.local.json
    └── hooks/
        └── lint-check.json
~/.copilot/
├── hooks/
│   └── lint-check.json
└── settings.json
~/.copilot/installed-plugins/<marketplace>/<plugin>/
└── hooks/
    └── hooks.json

{
    "version": 1,
    "hooks": {
        "preToolUse": [
            {
                "type": "command",
                "matcher": "bash",
                "bash": ".github/hooks/lint-check.sh",
                "powershell": ".github\\hooks\\lint-check.ps1"
            }
        ]
    }
}

Format : Cursor
Pour aller plus loin : events, matchers

repository/
└── .cursor/
    └── hooks.json
~/.cursor/
└── hooks.json
<plugin>/
└── .cursor-plugin/
    └── plugin.json

{
    "version": 1,
    "hooks": {
        "preToolUse": [
            {
                "command": "./hooks/lint-check.sh",
                "matcher": "Shell"
            }
        ]
    }
}

Format : Mistral Vibe
Pour aller plus loin : events, matchers, actions

repository/
└── .vibe/
    └── hooks.toml
~/.vibe/
└── hooks.toml

[[hooks]]
name = "lint-check"
type = "before_tool"
match = "bash"
command = "node .vibe/hooks/link-check.js"

Les hooks de projet se chargent avant les hooks utilisateur.

Format : Antigravity
Pour aller plus loin : events, matchers

repository/
└── .agents/
    └── hooks.json
~/.gemini/config/
└── hooks.json

{
    "PreToolUse": [
        {
            "matcher": "run_command",
            "hooks": [
                {
                    "type": "command",
                    "command": "./scripts/lint-check.sh"
                }
            ]
        }
    ]
}

Format : Devin
Pour aller plus loin : events

repository/
└── .devin/
    └── hooks.v1.json
~/.config/devin/
└── config.json
~/path/to/locally/installed/plugins/<name>/
└── hooks.json

{
    "PreToolUse": [
        {
            "matcher": "exec",
            "hooks": [
                {
                    "type": "command",
                    "command": "./scripts/lint-check.sh",
                    "timeout": 10
                }
            ]
        }
    ]
}

Format : Hermes Agent
Pour aller plus loin : events

<plugin>/
├── plugin.yaml
└── __init__.py

def register(ctx):
    ctx.register_hook("pre_tool_call", my_pre_tool_call)
    ctx.register_hook("post_tool_call", my_post_tool_call)
    ctx.register_hook("on_session_start", my_on_session_start)
    ctx.register_hook("pre_gateway_dispatch", my_pre_gateway_dispatch)