Skip to content

Configuration

claude-ops bot edited this page Apr 26, 2026 · 1 revision

Configuration

Every userConfig entry in plugin.json, what it does, and its default. All toggles are spacebar-toggleable from /plugins settings.

v2.0 toggles

Auto-fix subsystem (Auto-Fix Subsystem)

Key Type Default Purpose
deploy_fix_enabled boolean true Master switch.
monitor_post_merge boolean true Watch gh pr merge.
monitor_build_failures boolean true Watch npm run build:*.
auto_dispatch_fixer boolean true Off = log + notify only.
allow_dangerous boolean false Pass --dangerously-skip-permissions to fixer.
auto_rerun_transients boolean true Auto-gh run rerun on classified blips.
audit_health_after_deploy boolean true curl /health after success.
verify_served_commit boolean true curl /version and compare SHA.
fix_model string haiku haiku / sonnet / opus.
max_fixes_per_hour number 3 Per-repo cap (0..20).
watcher_timeout_seconds number 1800 Max wait for deploy completion (60..7200).
registry_path file ~/.claude/config/post-merge-services.json User registry.
repo_search_roots string ~/Projects:~ Where to find the repo on disk.
deploy_workflow_pattern string deploy|Deploy|build|Build|ECS|cd|CD Regex picking the deploy run.
notify_channel string macos macos/ntfy/pushover/discord/telegram/none.

Specialized agents (Specialized Agents)

Key Type Default Purpose
suggest_specialized_agents boolean true PreToolUse:Agent — silently swap general-purpose → matching specialist.

Recap marquee (Recap Marquee)

Key Type Default Purpose
recap_marquee_enabled boolean true Master switch.
recap_marquee_auto_configure_tmux boolean true Append marquee source to ~/.tmux.conf during setup.

Account rotator (Multi-Account Rotator)

Key Type Default Purpose
account_rotation_enabled boolean false Master switch (opt-in).
account_rotation_setup_oauth_each boolean true During /ops:setup, walk through OAuth init for every configured account that lacks a keychain token.

Task* tracking nudge

Key Type Default Purpose
task_reminder_enabled boolean true PostToolUse * hook nudging Claude to use TaskCreate/TaskUpdate.
task_reminder_threshold number 10 Non-Task tool calls before the reminder fires (3..50).

Safety hooks (Safety Hooks)

Not in userConfig. Always-on by design. Disable per-hook by editing hooks/hooks.json.


v1.x toggles (still current in v2)

Channel credentials, MCP tokens, and per-integration settings:

Group Keys
Telegram telegram_api_id, telegram_api_hash, telegram_phone, telegram_session, telegram_notify_chat_id
Sentry sentry_org
Linear linear_team
AWS aws_region
Marketing klaviyo_private_key, meta_ads_token, meta_ad_account_id, ga4_property_id (number), google_search_console_site
Shopify shopify_store_url, shopify_admin_token, shipbob_access_token
Voice bland_ai_api_key, elevenlabs_api_key, groq_api_key
Revenue stripe_secret_key, revenuecat_api_key, revenuecat_project_id
Monitoring datadog_api_key, datadog_app_key, newrelic_api_key, newrelic_account_id (number), otel_endpoint
Notifications ntfy_topic, pushover_user_key, pushover_app_token, discord_bot_token, discord_guild_id, discord_default_webhook_url
Doppler doppler_token, doppler_project, doppler_config
Shipping myparcel_api_key, sendcloud_*, dhl_parcel_*, postnl_*, dpd_*, ups_*, fedex_*

Note

v2.0 swept several entries from string → proper types: ga4_property_id and newrelic_account_id are now number; registry_path is file; all v2 toggles are boolean with explicit default so they render as spacebar-toggles in /plugins settings.

See also

  • Setup Wizard — interactive flow for configuring all of the above.
  • Migrating from v1 — none of the v1 keys changed; only the v2 keys are new.

Clone this wiki locally