Staso Docs
Reference

Environment variables

Core

VarMaps toDefault
STASO_API_KEYst.init(api_key=...)required
STASO_AGENT_NAMEst.init(agent_name=...)required
STASO_BASE_URLst.init(base_url=...)https://api.staso.ai
STASO_ENVIRONMENTst.init(environment=...)default
STASO_WORKSPACE_SLUGst.init(workspace_slug=...)default
STASO_DEBUGst.init(debug=...)unset

Guard

VarDescriptionDefault
STASO_GUARD_ENABLEDSet to false to disable Guard in patched integrations.true
STASO_GUARD_FAIL_CLOSEDSet to 1/true to return block on transport failure instead of allow.unset (fail-open)
STASO_GUARD_TIMEOUTHTTP request timeout for st.guard(...) calls, in seconds.10.0

Git / VCS override

Take precedence over auto-detection.

VarDescription
STASO_VCS_COMMIT_SHA40-char commit SHA.
STASO_VCS_BRANCHBranch name.
STASO_VCS_REPO_URLRepository URL.

CLI agents (Claude Code, Codex)

staso setup writes these into the target settings file. You don't usually set them manually.

VarDescription
STASO_API_KEYAuth for hook subprocess.
STASO_AGENT_NAMEDisplay name on the dashboard.
STASO_WORKSPACE_SLUGTarget workspace.
STASO_ENVIRONMENTEnvironment tag.
STASO_BASE_URLBackend URL override.