Skip to main content
The generated .github/workflows/gitascii.yml lives on your profile repository’s default branch. It uses Igorcbraz/GitAscii/action, whose Node 20 entry point is the bundled action/dist/index.js. The Action reads configurations and writes SVGs on gitascii; it does not read the GitAscii database.

​
When it runs

The schedule created by the migration engine is conditional on its dynamic-widget detection; normal editor publication explicitly enables scheduling. Check the YAML in your repository to see what is installed.

​
Permissions and inputs

The workflow grants contents: write to its GITHUB_TOKEN. Pro workflows also grant id-token: write to authenticate publication-policy requests and telemetry to GitAscii. The Action does not use the user’s OAuth access token. For scheduled runs, the effective interval is the larger of the input and the server’s publication policy. Pro policy has a 60-minute floor, but defaults to 1440 minutes when no interval is configured. A policy/OIDC failure falls back to 1440 minutes. The guard compares against the latest gitascii branch commit, not a per-profile timer. Manual dispatch bypasses this interval guard. The generator uses GITASCII_ACTION_SHA when configured on the backend, otherwise main. The generated workflow has a five-minute job timeout and cancels an earlier run in the same concurrency group. Existing repository workflows must be updated to pick up generator changes.

​
What a refresh publishes

  1. Read saved JSON configurations from gitascii.
  2. Fetch GitHub user and repository data, with best-effort GraphQL enrichment.
  3. Render dark and light images and process external assets.
  4. Compare file hashes and check that the branch/configuration has not advanced.
  5. Commit changed SVGs together using a non-forced branch update.
Pro reporting is best effort and is not required to commit SVGs. An asset placeholder can be published with an error report; a fatal failure before the commit leaves the previous files intact. See troubleshooting and health semantics. Source: Action definition, Action implementation, workflow generator.