Rules
Rules let Chronoid classify activity automatically. They are used across project assignment, distraction handling, ignore behavior, and web blocking.

Condition Types
Chronoid currently supports these condition types:
| Type | What It Matches | Example |
|---|---|---|
| App Name | Application display name | Safari |
| Application | Bundle identifier | com.apple.Safari |
| Window Title | Active window title text | Sprint Planning |
| Website URL | Domain name | github.com |
| URL Path | URL path only | /docs/api |
| File Path | File or folder path | /Users/me/Projects |
| Keyword Match | Title, path, domain, and URL text | meeting |
| Title or Path | Window title and file path together | README |
| Full URL | Complete URL including domain and path | instagram.com/reel/ |
Operators
Chronoid supports these operators:
| Operator | Meaning |
|---|---|
| Equals | Exact match |
| Contains | Text appears anywhere |
| Starts With | Value begins with the text |
| Ends With | Value ends with the text |
| Matches Regex | Regular expression match |
| In | Matches a predefined group |
| Not In | Excludes a predefined group |
Regex and group-based operators are useful when broad text matching is either too loose or too repetitive.
Where Rules Are Used
Compound Rules
Chronoid supports nested rule groups, so you can combine conditions with logic such as:
- AND
- OR
- NOR
That makes it possible to build rules like:
- a specific domain and a matching title
- a project assignment for one app but not a predefined distraction group
- a full URL pattern using regex
When To Use Newer Types
- Use Full URL when the domain alone is not specific enough.
- Use Title or Path when file-based work can appear either in a window title or in a filesystem path.
- Use Matches Regex when you need one rule to cover many similar patterns.
Tips
- Start with the narrowest rule that solves the problem.
- Use Website URL for broad domain matching and Full URL for route-specific matching.
- Test regex rules carefully before relying on them for billing or auto-assignment.
- Review older rules after major workflow changes so they do not overmatch.
For help, email support@chronoid.app