stokeDocumentation

Start here

Overview

Stoke brings Kiln and Bellows into one workspace for local GitHub Actions feedback. Bellows plans and runs the workflows; Kiln supplies the runner environment.

Clone Stoke and set up the pair. Each tool keeps its own source, history and releases.

Open documentation →
↑ ↓ navigate↵ open
On this page

Bellows

Compatibility

This table is generated from Bellows compatibility classifications.

StatusFeatureLocal BehaviorGuidance
supportedrunnerMapped GitHub, macOS fallback, and Blacksmith runner labelsReview .bellows.yml runner mappings before relying on local parity.
partialdynamic-runnerMatrix-driven runs-on expressionsMap every possible matrix runner value.
partialartifact-uploadactions/upload-artifact during local runsGuard upload steps with if: ${{ env.ACT != 'true' }} when needed.
partialactions-cacheactions/cache local behaviorTreat local cache hits as best effort and keep builds deterministic.
partialregistry-loginContainer registry login actionsProvide local credentials or skip publish jobs.
partialgithub-apiGitHub API calls from workflow stepsProvide a scoped token or guard the step for local runs.
unsupportedrunnerUnmapped runner labelsAdd runner.map entries before running locally.
unsupportedoidcGitHub OIDC token mintingKeep OIDC-backed cloud credential flows in cloud CI or skip locally.
unsupportedenvironment-protectionGitHub deployment environments and approvalsKeep protected deployments in cloud CI.
unsupportedcloud-credentialsCloud credential setup actions such as AWS OIDCSkip these jobs locally unless a local credential path is explicit.
unsupportedrelease-publishRelease publishing actionsAdd release jobs to skip.jobs.

Action Registry

This table is generated from Bellows action compatibility rules.

MatchStatusFeatureGuidance
docker/login-actionpartialregistry-loginskip publish jobs or provide local registry credentials
github-scriptpartialgithub-apiguard the step for local runs or provide a scoped token
softprops/action-gh-releaseunsupportedrelease-publishadd this job to skip.jobs
goreleaser/goreleaser-actionunsupportedrelease-publishadd this job to skip.jobs
Continue readingLocal differences →
Edit on GitHub
Open in chat

Opens with this page’s documentation in the prompt.