# kosa8 ci run

Start a pipeline run and follow its logs

Starts a run of a repository at a ref (default: this checkout's origin and branch;
push first: the run clones from the git host, not from this machine). Prints the
logs as they come and exits non-zero unless the run succeeds; --detach prints the
run's ID and returns.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--detach` | bool | print the run's ID and return |  |
| `--event` | string | push, pull_request, workflow_dispatch (default) or schedule |  |
| `--input` | stringArray | workflow_dispatch input NAME=value; repeat | `[]` |
| `--job` | string | act runs: one job id |  |
| `--ref` | string | branch, tag or SHA (default: this checkout's branch) |  |
| `--repo` | string | https:// clone URL (default: this checkout's origin) |  |
| `--secret` | stringArray | a kosa8 secret (made with pipelines: true) to give the jobs; repeat | `[]` |
| `--size` | string | act runs: the sandbox size, such as 4x8 |  |
| `--status-secret` | string | a secret with a GitHub token that sets the commit's status |  |
| `--timeout` | duration | the run's limit (default 1h, at most 6h) | `0s` |
| `--token-secret` | string | a secret with a token that can clone the repository (private repositories) |  |
| `--workflow` | string | act runs: one file in .github/workflows, such as ci.yml |  |

---
Source: https://docs.kosa8.com/reference/ci-run/
