Guides

Working with verbs

Verbs let a governed chat turn pull context on its own, against existing IPC, without leaving the loop. Depth is capped at 3.

How verbs run

Each turn is parsed for verb tokens. Matching verbs execute against the same IPC handlers the UI uses, and their results inject back as synthetic role:tool followups that trigger a re-stream. Output is bounded by hard caps at every boundary.

The verbs

  • <<read:path>> — read a file (size-capped, env-masked).
  • <<grep:pattern>> — search the project (regex, path-glob, guards).
  • <<symbol:name>> — look up a symbol in the code index.
  • <<exec:cmd>> — run an allowlisted, read-oriented command.
  • <<pw:smoke:url>> — Playwright smoke run with screenshot + console capture.
  • <<pw:steps:url|[steps]>> — a Playwright step sequence.

Full syntax: Verb reference.