Documentation

Git CLI and CI

Validate and operate Crucible Git workspaces from the CLI and CI.

CLI architecture

The crucible CLI uses the same storage-git and git-ops packages as Desktop. It does not shell arbitrary commands or store credentials.

Common commands

crucible workspace create --provider git --path ./api --name "API"
crucible workspace validate --path ./api
crucible git status --path ./api --json
crucible git stage --all --path ./api
crucible git commit --message "Update requests" --path ./api
crucible workspace publish-git --workspace "Local Name" --path ./out

CI

Install system Git ≥ 2.39, then validate the checkout:

crucible workspace validate --path "$GITHUB_WORKSPACE"

Exit codes: 0 success, 2 usage, 3 execution/auth/non-ff, 4 validation/conflict/secrets, 5 Git missing/unsupported, 130 cancelled.