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`
Cwd Changed	Configuration for cwd-changed hooks with path-based command execution	`commands`
Elicitation	Configuration for elicitation hooks with MCP-server-based command execution	`commands`
Elicitation Result	Configuration for elicitation-result hooks with MCP-server-based command execution	`commands`
File Changed	Configuration for file-changed hooks with path-based command execution	`commands`
Instructions Loaded	Configuration for instructions-loaded hooks with command execution	`commands`
Message Display	Configuration for message-display hooks	`commands`, `onlyFinal`
Notifications	Configuration for system notifications	`enabled`, `hooks`, `showErrors`
Permission Denied	Configuration for permission-denied hooks with tool-based command execution	`commands`
Permission Request	Configuration for permission request hooks that control tool permission decisions	`allow`, `default`, `deny`
Post Compact	Configuration for post-compact hooks with trigger-based command execution	`commands`
Post Tool Batch	Configuration for post-tool-batch hooks	`commands`
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`
Task Created	Configuration for task-created hooks with subject-based command execution	`commands`
Teammate Idle	Configuration for teammate idle hooks with pattern-based command execution	`commands`
User Prompt Expansion	Configuration for user-prompt-expansion hooks with command-name-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`