rt gate ask

rt › gate › ask

Open a gate with the daemon-side ceremony (subject resolution, presentation, nudge)

Usage

rt gate ask [flags]

Arguments & flags

Flag / Arg	Type	Default	Description
--questions	text		JSON array of questions ({value,label} option objects preferred; bare strings accepted)
--context	text		Optional decision context; over 8KB it is omitted, never an error
--kind	text		Gate kind (default question)
--subject	text		Explicit subject; omitted, the daemon resolves this session's run, else its agent record's subject
--json	boolean	false	Accepted for symmetry; output is always JSON

See code: commands/gate.ts › gateAsk

Examples & notes

gate ask is the high-level interface for opening a gate. It resolves the subject automatically (from the session's running run or agent record), determines the presentation mode, and nudges the operator.

rt gate ask \
  --questions '[{"id":"q1","label":"Deploy now?","multi":false,"options":[{"value":"yes","label":"Yes","recommended":true},{"value":"no","label":"No"}]}]' \
  --context "All tests pass. The deploy window closes in 30 minutes."

Options can be bare strings or objects with value, label, recommended, and description fields. An option marked recommended: true gets a "(Recommended)" badge in the UI. Each question can also carry its own context field for material specific to that choice (shares an 8 KB budget with the gate-level context).

See the gates guide for the full lifecycle and delivery mechanics.