Skip to main content

Settings

The Settings tab has five sections (left sidebar nav). Changes take effect live without restarting the daemon, except where noted.

Auto-approve rules​

Rules let you skip the approval modal for traffic you've already decided on — Read calls inside the project, Bash git status, etc.

  • Master kill switch — a single toggle that disables all rule evaluation in the daemon. The panic switch when something feels off.
  • Rules table — order (with ↑↓ to reorder), name, pattern + match type (literal / glob / regex), tool, scope (cwd glob), action (allow / deny / ask), match count, last-matched time.
  • Per-rule controls — toggle enabled, toggle dry-run, edit, delete.
  • Filter chips — All / Allow / Deny / Dry-run / Disabled.
  • Test playground — type a sample tool invocation and see whether any rule matches, with the matching rule highlighted.

When a rule is promoted from the audit log, it lands in the table with dry-run on by default: the daemon logs what would have happened without actually deciding, so you can verify the rule before letting it take over.

See the Rules editor for the create/edit form.

Notifications​

Per-channel toggles, urgency, and sound:

  • Approval needed — a permission request is pending.
  • Agent finished — a session ran to Stop.
  • Stuck detection — a working session has been idle past the threshold (opt-in; see Environment).
  • Quiet hours — a daily window during which non-critical notifications are suppressed (e.g., 22:00 → 08:00).

Each channel has:

  • An on/off toggle
  • An urgency level (low / normal / critical)
  • A sound toggle

Test notification sends a sample notify-send so you can confirm your desktop notification daemon picks it up.

Summaries​

Configures the smart-summary feature, which shells out to claude -p --no-settings to summarize a long session.

  • Enable smart summaries — master toggle.
  • Auto-refresh interval — how stale a cached summary can be before it can refresh.
  • Max concurrent invocations — caps simultaneous claude -p subprocesses so you don't burn through rate limits. Default is 2.
  • Recursion guard — locked on; prevents the summarizer's own claude invocations from being tracked as new sessions.

Retention​

Controls disk usage and how long history stays around.

  • Retention window — number of days before ended sessions are deleted.
  • Max events per session — when exceeded, the oldest events are trimmed first.

The approval audit log is preserved when sessions are deleted — it's the durable record of what the agent asked for and what was decided.

Hooks & daemon​

Operational knobs and a status panel.

  • Hook status — which events are installed, where the binaries resolve to, and any issues. Color-coded: green = all installed, yellow = some missing, red = settings file not found.
  • Settings file path — where ccmon writes its hook entries (defaults to ~/.claude/settings.json).
  • Port — the daemon's bound port. Editing requires a daemon restart.
  • Log level — debug / info / warning / error.