Readiness states

6 min readFor operatorsUpdated 2026-05-22

Craik resolves a progressive readiness state before shell actions, status checks, and slash-command dispatch. The resolver is intentionally non-blocking: it reports what is missing without requiring setup to already be complete.

States

unconfigured

first launch

No initialized local state, operator session, provider profile, or active model has been detected.

fixture

deterministic mode

Fixture mode is selected for local demos or tests. Live provider calls are not assumed.

local-model

local endpoint

A local OpenAI-compatible provider profile is configured without a full operator session.

operator-only

identity ready

An operator session exists, but no provider credential profile has been configured.

provider-only

credential ready

A provider credential profile exists, but no operator session is active.

fully-ready

runtime ready

Operator identity, provider credentials, and active model selection are all present.

restricted/offline

network constrained

CRAIK_OFFLINE=1 is active. Remote provider actions should not be attempted.

Surfaces

Use either command to inspect the same readiness payload:

craik status
craik slash /status

The JSON payload includes:

• state
• home
• initialized
• operator_authenticated
• provider_configured
• local_model_configured
• active_profile
• active_model
• missing
• next_actions
• warnings

Blocking behavior

Slash commands declare the readiness they need. Commands that only guide setup are always available. Commands that inspect protected runtime state return a clear blocked message until the required operator or provider state exists.