Token Controller Docs
Docs / Attribute / Rules

Rules

Rules place token entries on tickets and projects. They work like the rules in a banking app: set once, every new token entry lands where it belongs, and people only handle the exceptions.

Browse the docs

Signals

A signal is a fact about a session that hints at where its cost belongs:

Prompts and titles are read on the machine. Only the ticket keys found in them leave it, as Security and privacy lists.

The default rules

RulePlaces on
Ticket key in branchThat ticket
Ticket key in pull request titleThat ticket
Repository mapped to a projectThat project, as project overhead

Add your own in the web app under Rules, in the mod's pane, or with the CLI.

Order

Rules run in order, and the first that matches wins. Organization rules run before personal ones, so a person's own rules only handle what the organization's rules leave open.

When prompts name several tickets

By default the ticket named most often in your prompts wins, and on a tie the latest one. An organization can switch this to an equal split between the tickets, or to the first one named.

A mention is not work. "The follow-up ticket will be KD-260" names a ticket the session did not work on. Rules cannot tell the difference. The classifier can, and you can always place a token entry by hand.

When nothing matches

The token entry stays unattributed and shows up in your review list. The share placed by rules is your attribution; you set the attribution target.

Last updated 8 October 2026 · Edit this page © 2026 Jan Beck · Privacy · Imprint