onboarding

Override whether the first-run onboarding flow opens at interactive startup.

Three-state, parsed by classify_env_bool:

• Unset (or an unrecognized token): keep the default first-run behavior, i.e. run onboarding until the completion marker exists.
• Falsy (0, false, no, off, or empty): never open onboarding, even on a fresh install with no completion marker.
• Truthy (1, true, yes, on): force onboarding to open on every interactive startup, ignoring the completion marker.

Read by should_run_onboarding; skipping the flow this way does not write the completion marker, so unsetting the variable restores first-run behavior.

Directory for app-managed internal state (~/.deepagents/.state).

Holds files the app writes for its own bookkeeping — OAuth tokens, the sessions database, version-check caches, input history. Kept separate from top-level user-facing config and agent directories so listing/iterating ~/.deepagents doesn't conflate state with agents.

Marker filename under ~/.deepagents/.state after onboarding has completed.

Marker written after the first goal-criteria preference prompt is answered.

Start marker for the managed onboarding name memory block.

End marker for the managed onboarding name memory block.

Classify a raw env-var string as a truthy, falsy, or unrecognized token.

The single source of truth for which strings count as boolean on/off values; is_env_truthy and the config resolver both build on it so they agree on what "recognizably boolean" means.

Return the first-run onboarding marker path.

Return whether the user has completed onboarding.

Persist that onboarding has completed.

Return the goal criteria preference prompt marker path.

Return whether the goal criteria preference prompt was answered.

Persist that the goal criteria preference prompt was answered.

Persist the optional onboarding name into user agent memory.

Empty or whitespace-only names are skipped (no file is written).

Return the managed onboarding name block (markers included) if present.

Remove every onboarding-name marker occurrence from text.

A partial edit can leave a lone start or end marker behind. Stripping all marker strings before re-inserting the managed block keeps re-insertion from producing orphaned markers that would confuse extract_onboarding_name_block.

Return whether onboarding should open at interactive startup.

DEEPAGENTS_CODE_ONBOARDING overrides the marker in both directions: a truthy value forces the flow open on every startup, and a falsy value keeps it closed even on a fresh install. An unset or unrecognized value leaves the marker in charge, so the override never has to be unset to get first-run behavior back.