Noora Collapsible Step

Use this skill when a task emits many lines of progress and the final output should collapse back to one summarized line.

Basic Pattern

import Noora

try await Noora().collapsibleStep(
    title: "Authentication",
    successMessage: "Authenticated",
    errorMessage: "Failed to authenticate",
    visibleLines: 5
) { writeLine in
    for index in 0 ..< 20 {
        writeLine("Progressing \(index)/20")
        try await Task.sleep(nanoseconds: 200_000_000)
    }
}

Good Fit

• Build logs.
• Boot logs.
• Multi-line validation output.
• Streaming subprocess or remote-operation status.

Guidance

• Use visibleLines to show enough context without flooding the terminal.
• Keep each emitted line short and meaningful.
• Reserve this for tasks with multiple intermediate lines, not one-line state changes.

Avoid

• Printing directly to stdout inside the task while also using a collapsible step.
• Using collapsible steps for static summaries that could just be an alert or progress step.