Rules

TabBoy rules are JSON data evaluated against local tab snapshots. They can suggest grouping, moving, saving for later, or closing duplicates, but they never mutate the browser directly.

Safety boundary

Every imported or persisted rule is validated with Zod before it reaches the rules engine. Rules produce suggestions, not direct browser mutations.

Blocked in V1:

• $where
• unknown $... operators
• functions
• arbitrary JavaScript
• remote code
• prototype-pollution keys

Minimal example

{
  "id": "docs-basic",
  "name": "Docs tabs",
  "enabled": true,
  "priority": 10,
  "query": {
    "domain": { "$regex": "(^|\\.)docs\\.", "$options": "i" }
  },
  "suggest": [{ "type": "group", "title": "Docs", "color": "blue" }]
}

Contribution path

Use the rule preset issue form to propose a reusable default rule. Good proposals include a clear use case, sample tab patterns, and expected suggestions.

For detailed authoring notes, see docs/rules-authoring.md.