Cagire/docs/getting-started/staging.md

Arm / Launch

In Cagire, changes to playback happen in two steps. First you arm: you mark what you want to happen. Then you launch: you apply all armed changes at once. Nothing changes until you launch. It is simpler than it sounds.

Say you want patterns 04 and 05 to start playing together. You arm both (p on each), then launch (c). Both start at the same time. Want to stop them later? Arm them again, launch again. That's it.

This two-step process exists for good reasons:

• Multiple changes at once: queue several patterns to start/stop, launch them together.
• Clean timing: all changes land on beat or bar boundaries, never mid-step.
• Safe preparation: set up the next section while the current one keeps playing.

Arm changes, then launch

Arming is an essential feature to understand to be effective when doing live performances:

1. Open the Patterns view (F2 or Ctrl+Up from sequencer)
2. Navigate to a pattern you wish to change/play
3. Press p to arm it. The pending change is going to be displayed:
   • + (armed to play)
   • - (armed to stop)
   • m (armed to mute)
   • s (armed to solo)
   • etc.
4. Repeat for other patterns you want to change
5. Press c to launch all changes
6. Or press Esc to cancel

You can also arm mute/solo changes:

• Press m to arm a mute toggle
• Press x to arm a solo toggle
• Press Shift+m to clear all mutes
• Press Shift+x to clear all solos

A pattern might not start immediately depending on its quantization setting. It might wait for the next beat/bar boundary.

Status Indicators

Indicator	Meaning
>	Currently playing
+	Armed to play
-	Armed to stop
M	Muted
S	Soloed

A pattern can show combined indicators, e.g. > (playing) and - (armed to stop), or >M (playing and muted).

Armed patterns blink to make pending changes impossible to miss.

Quantization

Launched changes don't execute immediately. They wait for a quantization boundary:

Setting	Behavior
Immediate	Next sequencer tick
Beat	Next beat
1 Bar	Next bar (default)
2/4/8 Bars	Next 2, 4, or 8-bar boundary

Edit quantization in pattern properties (press e on a pattern).

Patterns always start at a beat-aligned position (phase-lock), staying in sync with other running patterns.