Continuous Integration
Run GitHub Actions-compatible workflows on Trylle Linux, ARM64, and macOS runners.
Trylle CI reads GitHub Actions-compatible YAML from both .github/workflows and .trylle/workflows. Existing workflows often run unchanged, but trigger coverage and several advanced features differ from GitHub Actions.
Check compatibility before migrating
Automatic runs currently support push and pull_request. Read the compatibility guide before relying on schedules, dynamic matrices, job containers, or GitHub token permission semantics.
Create your first workflow
Add .github/workflows/ci.yml or .trylle/workflows/ci.yml to the repository:
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci
- run: npm testCommit and push the file. A matching push or pull request queues the workflow and exposes its jobs under the repository's Actions tab.
Workflow locations and policy
Repository administrators control CI from Settings > Actions.
| Policy | Effect |
|---|---|
| Allow all actions and reusable workflows | Discovers enabled workflows in .github/workflows and .trylle/workflows. This is the default. |
| Allow only Trylle actions and workflows | Discovers enabled workflows only in .trylle/workflows; .github/workflows files are ignored. |
| Disable actions | Hides the Actions tab and prevents automatic and manual workflow runs. |
Individual workflow files can also be enabled or disabled. Policy and per-workflow settings apply to automatic events and manual dispatches.
The Trylle only policy filters the directory containing the workflow. It is not an allowlist for step-level uses: references: an enabled .trylle/workflows file can still invoke compatible external actions.
Runners
runs-on value | Environment |
|---|---|
ubuntu-latest | Linux x86_64 |
ubuntu-latest-arm | Linux arm64 |
macos-26 | macOS 26 arm64 |
macos-latest | macOS 26 arm64 |
Windows and unknown runner selectors are not currently available; jobs using them are skipped.
Continue with
Compatibility
Triggers, syntax, actions, runners, permissions, and current limitations.
Workflow examples
Copy compatible filters, matrices, reusable workflows, dispatch inputs, caches, and artifacts.
Secrets and variables
Configure repository and organization credentials and understand precedence.
Runs and logs
Inspect jobs, download artifacts, read logs, and cancel active work.
Usage
Understand runner-minute metering, credits, and queue time.