Range syntax cheat-sheet

Use two ranks for Hold’em hands, add s or o for suitedness, and separate alternatives with commas. A trailing + extends upward through the matching hand family.

Hold’em has two broad wildcard families. They are complete atoms, so adding a suited or offsuit suffix produces a typed family-suffix error.

A % selects hands by the current seat’s ranking. Bounds accept at most two decimal places and always require the percent sign.

Equity versus Balanced is a per-seat toggle beside the range, not parenthesized grammar. Balanced composition is limited where structural predicates require the Equity ranking.

Omaha patterns name the ranks held together; suits remain unrestricted unless cards or qualifiers pin them. Short broad patterns may auto-pad to the selected PLO hole size.

An asterisk occupies one unknown rank slot. The old x wildcard is retired because lowercase x, y, z, and w now bind per-card suits.

The selected variant fixes the hole size at 2, 4, 5, or 6 cards. Too-short guidance distinguishes Hold’em notation from explicit Omaha slots; too-long guidance tells you how many slots to remove.

Append a colon qualifier to an Omaha atom to constrain its sorted suit-count shape. These modifiers are PLO-only and must follow a hand atom.

Numeric vectors state exact sorted suit counts. PPT-style letter predicates read the sorted counts below; each row says when trailing singleton suits are allowed.

Rundown + and span sugar preserve a gap structure while moving through ranks. Gap qualifiers constrain rank-variable skeletons; on fully named ranks they are redundant.

Uppercase R, O, N, and P stand for ranks; repeated letters share a value and different letters must differ. Rank variables are Omaha-only.

These describe the shape of your hole cards' RANKS — how many pairs you hold — the way suit classes describe their suits. PLO4/PLO5/PLO6 only; they compose with a pattern, a suit class or a percentile.

Pasting from PPT / Odds Oracle: $np, $op and $nt map to :unpaired, :singlepaired and :notrips. $tp is asked about first, because Kairo has historically read it as top pair — pick the two-pair hand shape and it becomes :doublepaired.

Lowercase x, y, z, and w after a rank bind card suits. Reusing a letter requires the same suit; a different letter requires a different suit.

Categories filter a concrete range against the current board and work for both NLHE and PLO. They require a flop, turn, or river board before Kairo can plan them.

A bracket supplies several choices for one Omaha rank slot and expands into a small group. Brackets are PLO-only; NLHE returns a typed unsupported-syntax error.

Exact concrete lists are capped at 50,000 combos. Supported over-cap forms stay compact and stream or sample inside the engine; an unexpected over-cap expansion is reported instead of silently truncating.

Valid but empty means the grammar was accepted but intersections, exclusions, or blockers left no playable hands. Kairo prefers a specific reason; materialization-empty is the residual prompt to broaden or remove a filter.

Use ! to subtract hands or cards from the term on its left, and @N for a 1–100 term weight. A weight changes composition only inside a weighted union.

Commas combine alternatives. Every member must share a routing shape that Kairo can represent without silently mixing incompatible plans.

A colon between two atoms means both sides must hold. Qualifier and category keywords still win when they appear after the colon.

Parentheses bind a union before a following qualifier, exclusion, or weight. Grouped members must remain compatible after the modifier distributes.

Reference a saved range as $name; its variant and percentile mode travel with it, and compatible qualifiers distribute through it. Built-in aliases below are rendered from the parser registry.

This matrix shows REVIEWED catalog coverage, not every range the live compiler can compute. Each cell is checked against the same compiler used by the calculator. A feature may compute for some forms and return a named, typed error for others.

See the full capability catalog →