Core Concept

State Storage

Shiro can persist workflow state across runs, enabling pause/resume functionality and tracking execution history.

Storage Backends

Memory (Default)

State is stored in memory only. Lost when process exits. Good for testing and ephemeral workflows.

bash

shiro run -state-store memory

Filesystem

State persisted to local files. Good for local development and single-node deployments.

bash

shiro run -state-store filesystem

GitLab

State stored as GitLab CI artifacts. Perfect for GitLab CI/CD workflows with pause/resume.

bash

shiro run -state-store gitlab

Resume Workflows

State storage enables pausing and resuming workflows:

bash

# Initial run with fresh state
shiro run -state-store gitlab -fresh

# Resume from previous state (skip completed steps)
shiro run -state-store gitlab

State Data

Stored state includes:

• Completed step IDs and their outputs
• Workflow inputs and variables
• Execution timestamps
• Error information (if any)