Skip to content
claudewheel.defaults
Edit
On this page

Default values for config, segments, options, state, and themes; canonical permission rules, hook wiring, and the disallowed-tools list are derived from the guardrail model.

#claudewheel.defaults

#claudewheel.defaults

Default values for config, segments, options, state, and themes; canonical permission rules, hook wiring, and the disallowed-tools list are derived from the guardrail model.

#canonical_hook_command

python
def canonical_hook_command(scripts_dir: Path, script: str) -> str

Return the canonical hook command string for script under scripts_dir.

Single source of truth for how a hook command path is composed. Reused by _build_canonical_hooks (which deploys the wirings) and by health.check_hooks_wired (which verifies them), so verification matches deployment exactly instead of doing a lax substring match.

#_build_canonical_hooks

python
def _build_canonical_hooks(scripts_dir: Path) -> dict[str, Any]

Build the hooks dict from the guardrail model's EXPECTED_HOOK_WIRINGS.

Each wiring is an (event, matcher, script-name) tuple. Wirings are grouped by event, and within each event by matcher, so several scripts sharing an (event, matcher) pair land in one entry's hooks list. The guardrail module is the single source of truth -- adding a wiring there flows through here automatically.

#build_canonical_shared_settings

python
def build_canonical_shared_settings(scripts_dir: Path) -> dict[str, Any]

Build the canonical shared-settings dict from current defaults.

The hooks section is derived from guardrail.EXPECTED_HOOK_WIRINGS. The disallowedTools section comes from DISALLOWED_TOOLS above, which is itself derived from the guardrail model (DISALLOWED_TOOL_ENTRIES). The profileDefaults permissions deny/ask arrays are derived from the guardrail model (canonical_deny_rules() / canonical_ask_rules()). The profileDefaults section contains default settings applied to new profiles when no clone source is specified (previously lived in profile-defaults.json), and carries the CANONICAL_PROFILE_SETTINGS keys above.

More tools from this site

  • claudestream Drive Claude Code from Python: run it as a subprocess and read its output as typed events, with async and sync sessions, sandbox policies, and tools you define in Python
  • dirstat Fast, single-binary directory statistics CLI: every file under a tree grouped by format, with counts, sizes, and lines of code, as a colored terminal table or as JSON
  • fastware A batteries-included ASGI framework: msgspec JSON, a managed Granian server, dependency injection, SSE, WebSockets, auth, and a test client
  • go-toml-edit Zero-dep TOML editing library for Go with comment preservation
  • howmuchleft The fastest Claude Code statusline: context window, 5-hour, and weekly limit usage as three customizable gradient bars, rendering in about 6 ms
  • orxtra
  • pgdesign
  • predraw Declarative rendering pipeline: describe a scene in JSON and get SVG, PNG and WebP out, with light and dark style tokens, reusable components and text converted to path outlines
  • reposummary Turn a git repository's history into a Markdown journal: pick a time window or revision range and get a readable digest of what changed, optionally narrated by an LLM
  • rlsbl Release orchestration and project scaffolding CLI that bumps versions, validates a structured JSONL changelog, tags only the commit CI verified, and publishes to npm, PyPI, Go and more
  • safegit git wrapper CLI that gives each commit its own temporary index and retries ref updates on conflict, so concurrent agents share one repository
  • saferm Command-line replacement for rm that archives every deletion with a mandatory reason and the context it ran in, so deleted files can be listed, inspected and restored
  • selfdoc Static Site Generator that builds a project's documentation site directly from its source code, so the docs can never drift from the code they describe, with SEO/AEO, first-class blog, search, and cross-project linking built in
  • strictcli
  • stricttest An always-on test-isolation floor: a pytest plugin and a Go env-hygiene module that make a test suite structurally unable to reach real credentials, the real HOME, the network, or the development repository.
  • wesktop A Python framework that turns an ASGI web app into a desktop application, serving it from a local Granian server and displaying it in a native OS window via pywebview
Search