awml / platforms / github-actions-claude

GitHub Actions running Claude Code

Platform · Public ·
Version 1 of 2
  1. #2 · chrismdp · · 0.4Latest
  2. #1 · chrismdp · · 0.3Showing

GitHub Actions on GitHub-hosted runners, running a workflow file whose own steps are code and which calls Claude Code through anthropics/claude-code-action for the steps an agent carries out. This describes a kind of platform, not anyone's repository. GitHub, which runs the runner, sees everything the job handles, and the fit has no field for that. Checked against GitHub's and Anthropic's documentation on 22 October 2026.

description.yaml

description.yaml is AWML 0.3, as it was pushed. The fit reads it converted to AWML 0.8.

# GitHub Actions on GitHub-hosted runners, running a workflow file whose own steps are code and
# which calls Claude Code through anthropics/claude-code-action for the steps an agent carries out.
# This describes a kind of platform, not anyone's repository. GitHub, which runs the runner, sees
# everything the job handles, and the fit has no field for that. Checked against GitHub's and
# Anthropic's documentation on 22 October 2026.
awml: "0.3"
platform: { id: github-actions-claude, label: "GitHub Actions running Claude Code" }

# A hosted service that is always on. A schedule event can be delayed at busy times, most of all at
# the start of each hour, and under very high load some queued scheduled jobs are dropped, so
# schedule off the hour and give scheduled triggers a generous wait. The shortest schedule is every
# five minutes, and a public repository's schedules are turned off after 60 days without activity.
# https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule
off_for_up_to: PT0S

# The workflow file's steps run as code on the runner, the same way every time. A step that runs
# claude-code-action is where an agent decides.
# https://docs.github.com/en/actions/concepts/runners/github-hosted-runners
# https://code.claude.com/docs/en/github-actions
steps: code

# Claude Code runs on the runner with the checked-out repository and whatever secrets the job hands
# it. On Amazon Bedrock or Google Cloud instead of the Claude API, list that company here.
# https://code.claude.com/docs/en/github-actions
# https://code.claude.com/docs/en/github-actions-cloud-providers
agents: [anthropic]

# Each job gets a new virtual machine with ordinary internet access, so the workflow's own code can
# call any model company's API with a key from the repository's secrets.
# https://docs.github.com/en/actions/concepts/runners/github-hosted-runners
calls: any

# The runner holds the repository the job checks out, and keeps changes only by committing and
# pushing them. So it holds notes only when the notes are kept in that repository.
# https://docs.github.com/en/actions/concepts/runners/github-hosted-runners
holds: [notes]