Skip to main content
Live project control plane. The released engine discovers nika.yaml from the working directory toward its ancestors. The file is optional when built-in defaults are enough. Its project-shape grammar is closed: nika · ceiling · arm · traces · registry. Direct runs and the cadence path (nika arm · nika serve) read the same file.
arm: is the team registry of workflows the project proposes to fire. The file proposes. A machine edge disposes. Reading the file never schedules work.

One beat, complete

plafond and manqué have no default. Choosing them implicitly would choose who pays or whether missed work is duplicated or lost.

Read before firing

The report names each beat with its readiness, its next slots, and whether a sidecar proves a previous fire. It ends by stating that nothing was scheduled. Captured from nika 0.123.0 with the beat above (the project path is shortened):
[UNREADY] names what would refuse every fire (an unsupported miss policy, for example), and [DORMANT] a suspended beat. nika arm --json emits the same report for programs. Some lines are in French only in 0.124.3 (Known limits).
DECLARATION IS NOT PROOF

Every door ends at one firer

This convergence matters. Changing how the project wakes up does not change the firing law.

Suspend with a reason

Deleting a row leaves no durable explanation. The suspension triple states that the beat is inactive, why, and until when; nika arm reports it [DORMANT] with its reason and date. Pick a real future date: a past jusqu_au leaves the beat suspended with no explanation anyone believes.

Continue

Resident server

Keep the project clock alive without turning it into an HTTP API.

OS schedulers

Emit launchd or systemd user units.

Runtime state

Read firing ledgers, watermarks and run traces.

Full arm reference

Every policy, command, exit and sidecar file.