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.

Quick Reference

Section	Description	Key Options
Config Change	Configuration for config change hooks with source-based command execution	`commands`
Notifications	Configuration for system notifications	`enabled`, `hooks`, `showErrors`
Permission Request	Configuration for permission request hooks that control tool permission decisions	`allow`, `default`, `deny`
Pre Tool Use	Configuration for pre-tool-use hooks that run before tools are executed	`preventAdditions`, `preventRootAdditions`, `preventRootAdditionsMessage`
Setup	Configuration for setup hooks with trigger-based command execution	`commands`
Skill Start	Configuration for skill start hooks that trigger when subagents (skills) start	`commands`
Stop	Configuration for stop hook commands that run when Claude is about to stop	`commands`, `infinite`, `infiniteMessage`
Stop Failure	Configuration for stop failure hook commands that run when a turn ends due to an API error	`commands`
Subagent Stop	Configuration for subagent stop hooks with pattern-based command execution	`commands`
Task Completed	Configuration for task completed hooks with pattern-based command execution	`commands`
Teammate Idle	Configuration for teammate idle hooks with pattern-based command execution	`commands`
User Prompt Submit	Configuration for user prompt submit hook with context injection rules and command execution	`commands`, `contextRules`, `slashCommands`
Worktree Create	Configuration for worktree create hook	`command`, `timeout`