Triggers & auto-profiles
Watch terminal output with regex to notify, ring a bell, or capture text — and auto-recolor panes by host or directory.
Triggers let DiceTerm react to output as it arrives. Auto-profiles let it recolor a pane automatically based on where it's running. Together they help you keep track of what's happening across many panes without constantly watching them.
Triggers
Open Settings → Triggers to manage your trigger list.
How matching works
Every line of terminal output is tested against each trigger's JavaScript regex in order. Escape codes are stripped before matching, so the regex sees plain text. Two limits protect against pathological patterns:
- Lines are capped at 4 096 characters.
- The rolling match buffer is capped at 64 KB.
Actions
Each trigger has one action:
| Action | What happens |
|---|---|
| notify | An OS desktop notification pops up with the matched line |
| bell | A visual flash fires in the pane; if the pane is unfocused, the activity indicator lights up |
| capture | The matched line is sent to the Toolbelt → Captured output panel; if you have a webhook configured, the event is also posted there |
| alert | Taskbar attention request + an in-app banner + a desktop notification — the strongest signal |
Example use cases
- Catch
ERRORin a long build log and get a desktop notification. - Highlight every line containing your username in a shared log stream.
- Capture deployment URLs (matched by regex) into the Toolbelt so you can click them later.
- Fire an alert when a test run prints
FAILED.
Capture and webhooks
When a trigger fires a capture action, the matched line appears in Settings → Scripting if you have the HTTP API enabled. Specifically, it emits a webhook event:
{ "event": "capture", "paneId": "...", "line": "matched line text" }Webhooks must target localhost. See the scripting docs for endpoint details.
Auto-profiles
Open Settings → Auto-profiles to configure automatic pane recoloring.
Each entry has two parts:
- Match string — tested against the pane's current working directory path or its SSH host.
- Accent color — the color applied to the pane when the match is found.
When a pane's cwd or SSH host contains the match string, DiceTerm recolors the pane's accent automatically. Change directory and the accent updates in real time.
A common pattern is to match prod (or your production hostname) and assign a red accent, so production panes are visually distinct from staging or local ones.
Tip: Combine auto-profiles with the workspace accent color (set per workspace in the sidebar) for a two-level visual system: workspace color for the project, pane accent for the environment.
See also
- Search, copy & broadcast — view captured output in the Toolbelt with Ctrl+Shift+Y
- SSH — connect to the servers that auto-profiles match against