Ar9av/agent-manual

The manual for AI coding agent hooks, configs, PreToolUse/PostToolUse, MCP, and skills - covering Claude Code, Copilot, Cursor, Codex, Gemini CLI, and more.

14

44 commits

updated Sep 17, 2026

See the code

README

Agentic Tools Almanac Config Reference Hooks Matrix Frameworks and SDKs GitHub Repo

Agentic Tools Almanac ☤

The ultimate developer's index for AI coding agents. A community-driven reference for configuring, extending, and intercepting every major agentic development tool. Easily compare lifecycle hooks (e.g., PreToolUse and PostToolUse), built-in capabilities, Model Context Protocol (MCP) servers, system instruction file paths, and customized skills across 40+ different developer agents.

Universal Hooks IndexStandardized naming, exit-code blocking rules, and in-depth event execution behaviors for intercepting actions.
Comprehensive MatrixSide-by-side comparisons of file reads, shell commands, web searches, browser automation, and planning modes.
MCP Config ReferenceDirect paths, environment variables, local/remote stdio transports, and tool discovery rules.
Conventions & RulesWhere to write custom instruction files (e.g., CLAUDE.md, CONVENTIONS.md, .cursor/rules/) to customize agent behaviors.

Tools Covered

ToolVendorConfig formatHooksMCPOfficial docs
Claude CodeAnthropicJSON✅ Full (31 events)code.claude.com/docs/en/hooks
Codex CLIOpenAITOML✅ Full (10 events)developers.openai.com/codex
GitHub CopilotGitHub/MicrosoftJSON✅ Full (13 events)docs.github.com/en/copilot/reference/hooks-reference
Gemini CLIGoogleJSON✅ Full (11 events)geminicli.com/docs
Factory DroidFactory.aiJSON✅ Full (9 events)docs.factory.ai
Kiro IDE/CLIAmazon (AWS)YAML✅ Fullkiro.dev/docs
Kimi CodeMoonshot AITOML✅ Full — Beta (16 events)kimi.com/code/docs
CursorAnysphereJSON✅ Full (23 events)cursor.com/docs/hooks
HermesNousResearchYAML✅ Full (❓ events)hermes-agent.nousresearch.com
Devin CLICognition AIJSON✅ Full (7 events)cli.devin.ai/docs/extensibility/hooks
Pi Coding Agentearendil-worksJSON + YAML✅ Full (7 events)pi.dev
OpenCodeOpenCode.aiJSON✅ Via pluginsopencode.ai/docs
OpenClawOpenClawYAML✅ Full (18 events via Plugin SDK)docs.openclaw.ai
TraeByteDanceMarkdown rules⚠️ Via MCP onlydocs.trae.ai
Trae CNByteDanceMarkdown rules⚠️ Via MCP onlydocs.trae.ai
AiderAider-AIYAML❌ Not shippedaider.chat/docs
Google AntigravityGoogleJSON / TOML✅ Full (5 events)antigravity.google
Amazon Q Developer CLIAWSJSON✅ Full (5 events)docs.aws.amazon.com
AmpAmp (ex-Sourcegraph)JSON/JSONC⚠️ Plugin API (lifecycle events, no declarative hooks table)ampcode.com/manual
GooseAgentic AI Foundation (ex-Block)YAML✅ Full (11 events)goose-docs.ai
OpenHandsAll Hands AIJSON✅ Full (6 events)docs.openhands.dev
CrushCharmbraceletJSON⚠️ Partial (PreToolUse only)github.com/charmbracelet/crush
Continue CLIContinue Dev (acquired by Cursor)YAML/JSON✅ Full (17 events, undocumented officially)docs.continue.dev
Auggie CLIAugment CodeJSON✅ Full (5 events)docs.augmentcode.com
Qwen CodeAlibaba (QwenLM)JSON✅ Full (16 events)qwenlm.github.io/qwen-code-docs
Warp (Agent Mode)WarpJSON/Markdown❌ Not shipped (permissions/rules instead)docs.warp.dev
ClineCline Bot Inc.JSON + Markdown rules✅ Full (8 events, Unix-only)docs.cline.bot
Kilo CodeKilo-OrgJSONC⚠️ Via Plugin API (no exit-code hook contract)kilo.ai/docs
JunieJetBrains s.r.o.JSON✅ Full (7 events, CLI-only, confirmed)junie.jetbrains.com/docs
Grok BuildxAITOML✅ Full (14 events)docs.x.ai/build
Muse CodeMeta (Meta Superintelligence Labs)JSON✅ Full (12 events)dev.meta.ai/docs/muse-code
DeepSeek HarnessDeepSeekYAML (Cordis patches)⚠️ Via bridge plugin only (7 of ~30 Claude Code events)deepseek.com/harness
jcodeSolo SystemsTOML✅ Full (5 events, 1 blocking)jcode.sh/docs
PaseoPaseo (getpaseo)JSON✅ Full (11 hooks via TypeScript plugins — agent-lifecycle, not per-tool)✅ (server + injector)paseo.sh/docs
QMY Combinator (yc-software)JSONC + env (self-hosted)❌ Not shipped (security postures instead)✅ (admin-gated)qm.ycombinator.com
CodewhaleHmbown (community)TOML✅ Full (13 events, TUI-only)github.com/Hmbown/Codewhale
ReasonixESEngine (community)TOML + JSON (hooks)✅ Full (10 events)reasonix.io
oh-my-pican1357 (community)YAML✅ Via TS/JS extension modules (blocking)omp.sh
MiMo CodeXiaominpm plugins❌ Not shipped (plugins instead)✅ (OAuth-capable)mimo.xiaomi.com/mimocode
Prime AgentPrime Intellect❓ (packages)❌ Not shipped (capability packages instead)github.com/PrimeIntellect-ai/prime-agent
TauHugging FaceTOML❌ Not shipped (extensions instead)twotimespi.dev
Azure SRE AgentMicrosoftYAML (portal / REST v2)✅ Full (2 events)learn.microsoft.com/azure/sre-agent

Legend: ✅ Full = shipped, documented hook system with blocking · ⚠️ = partial or workaround · ❌ = not available · ❓ = unknown

Notes: Warp is primarily a GUI terminal app with an embedded agent (plus a separate oz CLI for headless/cloud use) — included here as a borderline entry, not a pure install-anywhere CLI like the others. Amazon Q Developer CLI is marked unmaintained by AWS as of this writing, with development moved to the closed-source Kiro CLI. Continue was acquired by Cursor/Anysphere in June 2026; its GitHub repo is now read-only. Goose was donated by Block to the Agentic AI Foundation (Linux Foundation) in 2026. Cline, Kilo Code, Junie, Grok Build, Muse Code, DeepSeek Harness, jcode, and QM were added 2026-08-15 as a doc-only pass (sourced from official docs/GitHub, not yet sandbox live-verified like the earlier entries) — several are brand-new (DeepSeek Harness shipped 2 days prior as a v0.1 preview) so expect more ❓s than the older pages; see _shared/source-audit.md. Paseo (added 2026-09-10, doc-only) is an orchestrator, not a coding agent — it launches and supervises other agent CLIs, and is listed here because it has its own config file, lifecycle hooks, MCP server, and skills. Codewhale, Reasonix, oh-my-pi, MiMo Code, Prime Agent, and Tau were added 2026-09-10 as a live-verified pass — all six were installed on the st3ve sandbox (Ubuntu 24.04) and driven through a real multi-step task against the OpenAI API; see each page's "Live Verification" section for what passed, what needed configuration, and what broke.

Azure SRE Agent is a hosted Azure service (configured via the portal or REST API v2), not a local CLI — the "Config format" column reflects its YAML hook schema, and it has no local config file or terminal binary. Its hook surface is limited to Stop and PostToolUse.


Quick Navigation

QuestionGo to
Which agents support activity X?_shared/activity-agent-matrix.md
What are all of Agent Y's hooks/tools/config?_shared/agent-tools-hooks-config.md
What is PreToolUse called in each tool?_shared/hook-event-comparison.md
Where does Tool Y store its config and skills?_shared/config-file-locations.md
Which pages still rely on community or inferred sources?_shared/source-audit.md
How do agent-specific tool names (Bash vs run_shell_command vs execute_bash...) map to a common taxonomy?_shared/tool-normalization-map.md
What did a session cost, and can I trust the tool's own number?_shared/token-cost-accounting.md
The agent runs in a hosted VM (Codex cloud, Claude Code on the web, Cursor cloud agents, Copilot, Replicas...) — what runs at boot, and which hook config does it load?_shared/cloud-agent-environments.md
Do we track orchestration frameworks and SDKs too?frameworks/README.md

Frameworks & SDKs

These are tracked separately from the coding-agent matrices because they are developer frameworks/runtimes rather than end-user CLI agents with a shared hooks/config surface.

Framework / SDKVendorNotesDocs
LangGraphLangChainLow-level stateful agent orchestrationhttps://github.com/langchain-ai/langgraph
CrewAICrewAI, Inc.Crews, flows, memory, guardrailshttps://docs.crewai.com/
AutoGenMicrosoftStable docs tracked instead of unverified "2.0" brandinghttps://microsoft.github.io/autogen/stable/
MastraMastraTypeScript agent/app frameworkhttps://mastra.ai/
OpenAI Agents SDKOpenAIAgent runtime with handoffs, guardrails, MCPhttps://openai.github.io/openai-agents-python/
Pydantic AIPydanticPython agent framework with typed outputshttps://pydantic.dev/docs/ai/overview/
Claude Code Agent SDKAnthropicOfficial product name for the requested "Anthropic Agent SDK"https://code.claude.com/docs/en/agent-sdk/overview
Google ADKGoogleAgent Development Kithttps://adk.dev/
Microsoft Agent FrameworkMicrosoftDirect successor to Semantic Kernel + AutoGen; Harness reached GA 2026-07-22, orchestration patterns reached 1.0 on 2026-07-08https://learn.microsoft.com/en-us/agent-framework/overview/agent-framework-overview

Repository Structure

.
├── README.md                          # Master index + comparative benchmarks
├── frameworks/
│   └── README.md                      # Sourced framework / SDK catalog
├── tools/
│   └── <tool-name>/
│       └── README.md                 # Per-tool configuration & command references
├── _shared/
│   ├── activity-agent-matrix.md      # Capabilities matrix (natively supported tools)
│   ├── agent-tools-hooks-config.md   # Unified agent specifications & schemas
│   ├── source-audit.md               # Source coverage audit and unresolved gaps
│   ├── hook-event-comparison.md      # Cross-agent hook event name lookup
│   ├── mcp-support.md                # MCP client capabilities & transport settings
│   ├── cloud-agent-environments.md   # Hosted platforms: boot scripts + which hook config the cloud agent loads
│   └── config-file-locations.md      # Global/local paths & git-ignored overrides
└── _templates/
    └── tool-template.md              # Blueprint for documenting new developer tools

Hook Event Cross-Reference

How the same lifecycle moment is named across tools:

Lifecycle momentClaude CodeCodexGemini CLIGitHub CopilotKimi CodeFactory DroidCursorDevin CLIPi AgentClineJunieGrok BuildjcodeMuse Code
Before any toolPreToolUsePreToolUseBeforeToolpreToolUsePreToolUsePreToolUsepreToolUsePreToolUsetool.before.*PreToolUsePreToolUsePreToolUsepre_toolPreToolUse
After any toolPostToolUsePostToolUseAfterToolpostToolUsePostToolUsePostToolUsepostToolUsePostToolUsetool.after.*PostToolUsePostToolUsepost_toolPostToolUse
After tool failsPostToolUseFailurepostToolUseFailurePostToolUseFailurepostToolUseFailurePostToolUseFailure
Prompt submittedUserPromptSubmitUserPromptSubmitBeforeAgentuserPromptSubmittedUserPromptSubmitUserPromptSubmitbeforeSubmitPromptUserPromptSubmitUserPromptSubmitUserPromptSubmitUserPromptSubmitUserPromptSubmit
Agent turn endsStopStopAfterAgentagentStopStopStopstopStopStopStopturn_endStop
Subagent startsSubagentStartSubagentStartsubagentStartSubagentStartsubagentStartSubagentStartSubagentStart
Session startsSessionStartSessionStartSessionStartsessionStartSessionStartSessionStartsessionStartSessionStartsession.createdSessionStartSessionStartsession_startSessionStart
Session endsSessionEndSessionEndsessionEndSessionEndsessionEndSessionEndSessionEndsession_end
Context compactedPreCompactPreCompactPreCompresspreCompactPreCompactPreCompactpreCompactPreCompactPreCompactPreCompact
Permission requestPermissionRequestPermissionRequestpermissionRequestPermissionRequestPermissionRequestPermissionDeniedPermissionRequest
LLM callBeforeModel / AfterModelPreLLMCall / PostLLMCall
NotificationNotificationNotificationnotificationNotificationNotification

Blocking Mechanism Comparison

How each tool's PreToolUse-equivalent blocks a tool call:

ToolBlock methodStderr / reason goes to
Claude CodeExit 2LLM as context
Codex CLIExit 2 or {"decision":"block"} stdoutLLM
GitHub Copilot{"permissionDecision":"deny"} stdoutLLM (via permissionDecisionReason)
Gemini CLIExit 2LLM
Factory Droid{"permissionDecision":"deny"} stdoutLLM
Kimi CodeExit 2 or {"permissionDecision":"deny"} stdoutLLM
CursorExit 2 + failClosed optionLLM
Hermes{"action":"block","message":"..."} stdoutLLM
Devin CLIExit 2 or {"decision":"block"} stdoutLLM
KiroExit 2LLM
Pi AgentExit 2LLM
Azure SRE AgentExit 2 or {"decision":"block"} stdout (PostToolUse); reject with reason (Stop)LLM (via reason / additionalContext)

Source Confidence Key

Each tool README labels sources:

LabelMeaning
[official]Published by the vendor on their own docs site
[github]Vendor GitHub repo (README, source code)
[official mirror]Vendor-maintained mirror of official docs
[community]Community-maintained project (e.g., oh-my-pi) — may diverge from vendor
[third-party]Non-vendor package index, mirror, or independently maintained page
[press]News or press coverage, useful for release context but not normative product behavior
[installer-src]Inferred from the installer scripts or directory structures

Contributing

See _templates/tool-template.md for the standard page format.

When adding or updating a tool:

  1. Source everything to an official URL — no guessing.
  2. Mark uncertain items with ❓.
  3. Use the [official] / [github] / [community] labels in the Sources table.
  4. Update the master table in this README.
  5. Update _shared/agent-tools-hooks-config.md with the agent's section.

Data Sources & Disclaimer

The Hook Event Cross-Reference table and event counts in the Tools Covered table are sourced directly from each tool's official documentation at the time of last update. Hook APIs evolve rapidly — vendor docs are the authoritative source and should always be consulted before relying on counts or event names listed here. Entries marked ❓ could not be verified against live official documentation at the time of writing.

Contributors

Ar9av

44 commits

Ar9av/agent-manual

The manual for AI coding agent hooks, configs, PreToolUse/PostToolUse, MCP, and skills - covering Claude Code, Copilot, Cursor, Codex, Gemini CLI, and more.

14

44 commits

updated Sep 17, 2026

See the code

README

Agentic Tools Almanac Config Reference Hooks Matrix Frameworks and SDKs GitHub Repo

Agentic Tools Almanac ☤

The ultimate developer's index for AI coding agents. A community-driven reference for configuring, extending, and intercepting every major agentic development tool. Easily compare lifecycle hooks (e.g., PreToolUse and PostToolUse), built-in capabilities, Model Context Protocol (MCP) servers, system instruction file paths, and customized skills across 40+ different developer agents.

Universal Hooks IndexStandardized naming, exit-code blocking rules, and in-depth event execution behaviors for intercepting actions.
Comprehensive MatrixSide-by-side comparisons of file reads, shell commands, web searches, browser automation, and planning modes.
MCP Config ReferenceDirect paths, environment variables, local/remote stdio transports, and tool discovery rules.
Conventions & RulesWhere to write custom instruction files (e.g., CLAUDE.md, CONVENTIONS.md, .cursor/rules/) to customize agent behaviors.

Tools Covered

ToolVendorConfig formatHooksMCPOfficial docs
Claude CodeAnthropicJSON✅ Full (31 events)code.claude.com/docs/en/hooks
Codex CLIOpenAITOML✅ Full (10 events)developers.openai.com/codex
GitHub CopilotGitHub/MicrosoftJSON✅ Full (13 events)docs.github.com/en/copilot/reference/hooks-reference
Gemini CLIGoogleJSON✅ Full (11 events)geminicli.com/docs
Factory DroidFactory.aiJSON✅ Full (9 events)docs.factory.ai
Kiro IDE/CLIAmazon (AWS)YAML✅ Fullkiro.dev/docs
Kimi CodeMoonshot AITOML✅ Full — Beta (16 events)kimi.com/code/docs
CursorAnysphereJSON✅ Full (23 events)cursor.com/docs/hooks
HermesNousResearchYAML✅ Full (❓ events)hermes-agent.nousresearch.com
Devin CLICognition AIJSON✅ Full (7 events)cli.devin.ai/docs/extensibility/hooks
Pi Coding Agentearendil-worksJSON + YAML✅ Full (7 events)pi.dev
OpenCodeOpenCode.aiJSON✅ Via pluginsopencode.ai/docs
OpenClawOpenClawYAML✅ Full (18 events via Plugin SDK)docs.openclaw.ai
TraeByteDanceMarkdown rules⚠️ Via MCP onlydocs.trae.ai
Trae CNByteDanceMarkdown rules⚠️ Via MCP onlydocs.trae.ai
AiderAider-AIYAML❌ Not shippedaider.chat/docs
Google AntigravityGoogleJSON / TOML✅ Full (5 events)antigravity.google
Amazon Q Developer CLIAWSJSON✅ Full (5 events)docs.aws.amazon.com
AmpAmp (ex-Sourcegraph)JSON/JSONC⚠️ Plugin API (lifecycle events, no declarative hooks table)ampcode.com/manual
GooseAgentic AI Foundation (ex-Block)YAML✅ Full (11 events)goose-docs.ai
OpenHandsAll Hands AIJSON✅ Full (6 events)docs.openhands.dev
CrushCharmbraceletJSON⚠️ Partial (PreToolUse only)github.com/charmbracelet/crush
Continue CLIContinue Dev (acquired by Cursor)YAML/JSON✅ Full (17 events, undocumented officially)docs.continue.dev
Auggie CLIAugment CodeJSON✅ Full (5 events)docs.augmentcode.com
Qwen CodeAlibaba (QwenLM)JSON✅ Full (16 events)qwenlm.github.io/qwen-code-docs
Warp (Agent Mode)WarpJSON/Markdown❌ Not shipped (permissions/rules instead)docs.warp.dev
ClineCline Bot Inc.JSON + Markdown rules✅ Full (8 events, Unix-only)docs.cline.bot
Kilo CodeKilo-OrgJSONC⚠️ Via Plugin API (no exit-code hook contract)kilo.ai/docs
JunieJetBrains s.r.o.JSON✅ Full (7 events, CLI-only, confirmed)junie.jetbrains.com/docs
Grok BuildxAITOML✅ Full (14 events)docs.x.ai/build
Muse CodeMeta (Meta Superintelligence Labs)JSON✅ Full (12 events)dev.meta.ai/docs/muse-code
DeepSeek HarnessDeepSeekYAML (Cordis patches)⚠️ Via bridge plugin only (7 of ~30 Claude Code events)deepseek.com/harness
jcodeSolo SystemsTOML✅ Full (5 events, 1 blocking)jcode.sh/docs
PaseoPaseo (getpaseo)JSON✅ Full (11 hooks via TypeScript plugins — agent-lifecycle, not per-tool)✅ (server + injector)paseo.sh/docs
QMY Combinator (yc-software)JSONC + env (self-hosted)❌ Not shipped (security postures instead)✅ (admin-gated)qm.ycombinator.com
CodewhaleHmbown (community)TOML✅ Full (13 events, TUI-only)github.com/Hmbown/Codewhale
ReasonixESEngine (community)TOML + JSON (hooks)✅ Full (10 events)reasonix.io
oh-my-pican1357 (community)YAML✅ Via TS/JS extension modules (blocking)omp.sh
MiMo CodeXiaominpm plugins❌ Not shipped (plugins instead)✅ (OAuth-capable)mimo.xiaomi.com/mimocode
Prime AgentPrime Intellect❓ (packages)❌ Not shipped (capability packages instead)github.com/PrimeIntellect-ai/prime-agent
TauHugging FaceTOML❌ Not shipped (extensions instead)twotimespi.dev
Azure SRE AgentMicrosoftYAML (portal / REST v2)✅ Full (2 events)learn.microsoft.com/azure/sre-agent

Legend: ✅ Full = shipped, documented hook system with blocking · ⚠️ = partial or workaround · ❌ = not available · ❓ = unknown

Notes: Warp is primarily a GUI terminal app with an embedded agent (plus a separate oz CLI for headless/cloud use) — included here as a borderline entry, not a pure install-anywhere CLI like the others. Amazon Q Developer CLI is marked unmaintained by AWS as of this writing, with development moved to the closed-source Kiro CLI. Continue was acquired by Cursor/Anysphere in June 2026; its GitHub repo is now read-only. Goose was donated by Block to the Agentic AI Foundation (Linux Foundation) in 2026. Cline, Kilo Code, Junie, Grok Build, Muse Code, DeepSeek Harness, jcode, and QM were added 2026-08-15 as a doc-only pass (sourced from official docs/GitHub, not yet sandbox live-verified like the earlier entries) — several are brand-new (DeepSeek Harness shipped 2 days prior as a v0.1 preview) so expect more ❓s than the older pages; see _shared/source-audit.md. Paseo (added 2026-09-10, doc-only) is an orchestrator, not a coding agent — it launches and supervises other agent CLIs, and is listed here because it has its own config file, lifecycle hooks, MCP server, and skills. Codewhale, Reasonix, oh-my-pi, MiMo Code, Prime Agent, and Tau were added 2026-09-10 as a live-verified pass — all six were installed on the st3ve sandbox (Ubuntu 24.04) and driven through a real multi-step task against the OpenAI API; see each page's "Live Verification" section for what passed, what needed configuration, and what broke.

Azure SRE Agent is a hosted Azure service (configured via the portal or REST API v2), not a local CLI — the "Config format" column reflects its YAML hook schema, and it has no local config file or terminal binary. Its hook surface is limited to Stop and PostToolUse.


Quick Navigation

QuestionGo to
Which agents support activity X?_shared/activity-agent-matrix.md
What are all of Agent Y's hooks/tools/config?_shared/agent-tools-hooks-config.md
What is PreToolUse called in each tool?_shared/hook-event-comparison.md
Where does Tool Y store its config and skills?_shared/config-file-locations.md
Which pages still rely on community or inferred sources?_shared/source-audit.md
How do agent-specific tool names (Bash vs run_shell_command vs execute_bash...) map to a common taxonomy?_shared/tool-normalization-map.md
What did a session cost, and can I trust the tool's own number?_shared/token-cost-accounting.md
The agent runs in a hosted VM (Codex cloud, Claude Code on the web, Cursor cloud agents, Copilot, Replicas...) — what runs at boot, and which hook config does it load?_shared/cloud-agent-environments.md
Do we track orchestration frameworks and SDKs too?frameworks/README.md

Frameworks & SDKs

These are tracked separately from the coding-agent matrices because they are developer frameworks/runtimes rather than end-user CLI agents with a shared hooks/config surface.

Framework / SDKVendorNotesDocs
LangGraphLangChainLow-level stateful agent orchestrationhttps://github.com/langchain-ai/langgraph
CrewAICrewAI, Inc.Crews, flows, memory, guardrailshttps://docs.crewai.com/
AutoGenMicrosoftStable docs tracked instead of unverified "2.0" brandinghttps://microsoft.github.io/autogen/stable/
MastraMastraTypeScript agent/app frameworkhttps://mastra.ai/
OpenAI Agents SDKOpenAIAgent runtime with handoffs, guardrails, MCPhttps://openai.github.io/openai-agents-python/
Pydantic AIPydanticPython agent framework with typed outputshttps://pydantic.dev/docs/ai/overview/
Claude Code Agent SDKAnthropicOfficial product name for the requested "Anthropic Agent SDK"https://code.claude.com/docs/en/agent-sdk/overview
Google ADKGoogleAgent Development Kithttps://adk.dev/
Microsoft Agent FrameworkMicrosoftDirect successor to Semantic Kernel + AutoGen; Harness reached GA 2026-07-22, orchestration patterns reached 1.0 on 2026-07-08https://learn.microsoft.com/en-us/agent-framework/overview/agent-framework-overview

Repository Structure

.
├── README.md                          # Master index + comparative benchmarks
├── frameworks/
│   └── README.md                      # Sourced framework / SDK catalog
├── tools/
│   └── <tool-name>/
│       └── README.md                 # Per-tool configuration & command references
├── _shared/
│   ├── activity-agent-matrix.md      # Capabilities matrix (natively supported tools)
│   ├── agent-tools-hooks-config.md   # Unified agent specifications & schemas
│   ├── source-audit.md               # Source coverage audit and unresolved gaps
│   ├── hook-event-comparison.md      # Cross-agent hook event name lookup
│   ├── mcp-support.md                # MCP client capabilities & transport settings
│   ├── cloud-agent-environments.md   # Hosted platforms: boot scripts + which hook config the cloud agent loads
│   └── config-file-locations.md      # Global/local paths & git-ignored overrides
└── _templates/
    └── tool-template.md              # Blueprint for documenting new developer tools

Hook Event Cross-Reference

How the same lifecycle moment is named across tools:

Lifecycle momentClaude CodeCodexGemini CLIGitHub CopilotKimi CodeFactory DroidCursorDevin CLIPi AgentClineJunieGrok BuildjcodeMuse Code
Before any toolPreToolUsePreToolUseBeforeToolpreToolUsePreToolUsePreToolUsepreToolUsePreToolUsetool.before.*PreToolUsePreToolUsePreToolUsepre_toolPreToolUse
After any toolPostToolUsePostToolUseAfterToolpostToolUsePostToolUsePostToolUsepostToolUsePostToolUsetool.after.*PostToolUsePostToolUsepost_toolPostToolUse
After tool failsPostToolUseFailurepostToolUseFailurePostToolUseFailurepostToolUseFailurePostToolUseFailure
Prompt submittedUserPromptSubmitUserPromptSubmitBeforeAgentuserPromptSubmittedUserPromptSubmitUserPromptSubmitbeforeSubmitPromptUserPromptSubmitUserPromptSubmitUserPromptSubmitUserPromptSubmitUserPromptSubmit
Agent turn endsStopStopAfterAgentagentStopStopStopstopStopStopStopturn_endStop
Subagent startsSubagentStartSubagentStartsubagentStartSubagentStartsubagentStartSubagentStartSubagentStart
Session startsSessionStartSessionStartSessionStartsessionStartSessionStartSessionStartsessionStartSessionStartsession.createdSessionStartSessionStartsession_startSessionStart
Session endsSessionEndSessionEndsessionEndSessionEndsessionEndSessionEndSessionEndsession_end
Context compactedPreCompactPreCompactPreCompresspreCompactPreCompactPreCompactpreCompactPreCompactPreCompactPreCompact
Permission requestPermissionRequestPermissionRequestpermissionRequestPermissionRequestPermissionRequestPermissionDeniedPermissionRequest
LLM callBeforeModel / AfterModelPreLLMCall / PostLLMCall
NotificationNotificationNotificationnotificationNotificationNotification

Blocking Mechanism Comparison

How each tool's PreToolUse-equivalent blocks a tool call:

ToolBlock methodStderr / reason goes to
Claude CodeExit 2LLM as context
Codex CLIExit 2 or {"decision":"block"} stdoutLLM
GitHub Copilot{"permissionDecision":"deny"} stdoutLLM (via permissionDecisionReason)
Gemini CLIExit 2LLM
Factory Droid{"permissionDecision":"deny"} stdoutLLM
Kimi CodeExit 2 or {"permissionDecision":"deny"} stdoutLLM
CursorExit 2 + failClosed optionLLM
Hermes{"action":"block","message":"..."} stdoutLLM
Devin CLIExit 2 or {"decision":"block"} stdoutLLM
KiroExit 2LLM
Pi AgentExit 2LLM
Azure SRE AgentExit 2 or {"decision":"block"} stdout (PostToolUse); reject with reason (Stop)LLM (via reason / additionalContext)

Source Confidence Key

Each tool README labels sources:

LabelMeaning
[official]Published by the vendor on their own docs site
[github]Vendor GitHub repo (README, source code)
[official mirror]Vendor-maintained mirror of official docs
[community]Community-maintained project (e.g., oh-my-pi) — may diverge from vendor
[third-party]Non-vendor package index, mirror, or independently maintained page
[press]News or press coverage, useful for release context but not normative product behavior
[installer-src]Inferred from the installer scripts or directory structures

Contributing

See _templates/tool-template.md for the standard page format.

When adding or updating a tool:

  1. Source everything to an official URL — no guessing.
  2. Mark uncertain items with ❓.
  3. Use the [official] / [github] / [community] labels in the Sources table.
  4. Update the master table in this README.
  5. Update _shared/agent-tools-hooks-config.md with the agent's section.

Data Sources & Disclaimer

The Hook Event Cross-Reference table and event counts in the Tools Covered table are sourced directly from each tool's official documentation at the time of last update. Hook APIs evolve rapidly — vendor docs are the authoritative source and should always be consulted before relying on counts or event names listed here. Entries marked ❓ could not be verified against live official documentation at the time of writing.

Contributors

Ar9av

44 commits