Skip to content

Configuration Reference

Conclaude uses YAML configuration files to define lifecycle hooks, file protection rules, and workflow policies for Claude Code sessions. The configuration system is discovered via cosmiconfig and validated against a JSON Schema to ensure correctness.

IDE Support: Conclaude provides a JSON Schema for configuration validation and autocomplete in your editor. The schema is available at conclaude-schema.json and can be referenced in your YAML files for enhanced editing support.

SectionDescriptionKey Options
NotificationsConfiguration for system notificationsenabled, hooks, showErrors
Permission RequestConfiguration for permission request hooks that control tool permission decisionsallow, default, deny
Pre Tool UseConfiguration for pre-tool-use hooks that run before tools are executedgeneratedFileMessage, preventAdditions, preventGeneratedFileEdits
StopConfiguration for stop hook commands that run when Claude is about to stopcommands, infinite, infiniteMessage
Subagent StopConfiguration for subagent stop hooks with pattern-based command executioncommands
User Prompt SubmitConfiguration for user prompt submit hook with context injection rulescontextRules

Detailed documentation for each configuration section:

Configuration for system notifications.

Configuration for permission request hooks that control tool permission decisions.

Configuration for pre-tool-use hooks that run before tools are executed.

Configuration for stop hook commands that run when Claude is about to stop

Configuration for subagent stop hooks with pattern-based command execution.

Configuration for user prompt submit hook with context injection rules