Skip to main content

Instance

Searches for occurrences of the input target's text. Instance matching preserves the target's scope type, so an instance of a token only matches complete tokens rather than substrings within larger tokens; apply "just" to match the raw text instead.

For a range target, the entire range becomes the search text. Without an explicit mark, Cursorless uses the token touching the cursor. Use "from" to restrict the search region or choose its starting point.

Cursorless ID: instance

Spoken form​

Default: instance

Syntax​

  • instance - Occurrence matching the current instance.

Examples​

  • "take every instance blue air" - Selects every instance of the token containing letter a with a blue hat.
  • "take every instance blue air past green bat" - Selects every occurrence of the text spanning from the token containing letter a with a blue hat through the token containing letter b with a green hat.
  • "take next instance blue air" - Selects the next instance of the token containing letter a with a blue hat.
  • "take every instance" - Selects every instance of the token touching the cursor.