mayros ci
CI/CD pipeline management. List, inspect, trigger, cancel, and retrieve logs from pipeline runs across GitHub Actions and GitLab CI providers. Runs are optionally recorded in the Cortex knowledge graph.
Subcommands
ci runs <repo>
List recent pipeline runs for a repository.
| Argument | Description |
|---|---|
<repo> | Repository identifier (e.g., owner/repo) |
Options:
| Flag | Description |
|---|---|
--branch <branch> | Filter runs by branch |
--limit <n> | Maximum runs to return (default: 20) |
--provider <p> | Provider: github or gitlab |
ci status <repo> <runId>
Get the detailed status of a specific pipeline run.
| Argument | Description |
|---|---|
<repo> | Repository identifier |
<runId> | Run or pipeline ID |
Options: --provider <p> (github or gitlab)
Displays: run ID, provider, repo, branch, status, URL, start time, and completion time.
ci trigger <repo>
Trigger a new pipeline run on a specific branch.
| Argument | Description |
|---|---|
<repo> | Repository identifier |
Options:
| Flag | Description |
|---|---|
--branch <branch> | (required) Branch to run on |
--workflow <w> | Workflow file (GitHub Actions only, e.g., ci.yml) |
--provider <p> | Provider: github or gitlab |
ci cancel <repo> <runId>
Cancel a running pipeline.
| Argument | Description |
|---|---|
<repo> | Repository identifier |
<runId> | Run or pipeline ID |
Options: --provider <p> (github or gitlab)
ci logs <repo> <runId>
Retrieve logs from a pipeline run.
| Argument | Description |
|---|---|
<repo> | Repository identifier |
<runId> | Run or pipeline ID |
Options: --provider <p> (github or gitlab)
Provider configuration
Providers are configured in mayros.toml under the ci-plugin section:
toml[ci-plugin] namespace = "ci" registerInCortex = true [[ci-plugin.providers]] type = "github" token = "${GITHUB_TOKEN}" [[ci-plugin.providers]] type = "gitlab" token = "${GITLAB_TOKEN}" baseUrl = "https://gitlab.example.com"
When no --provider flag is given, the first configured provider is used.
Examples
bashmayros ci runs owner/repo mayros ci runs owner/repo --branch main --limit 5 mayros ci status owner/repo 12345 mayros ci trigger owner/repo --branch feature/new-api mayros ci trigger owner/repo --branch main --workflow deploy.yml --provider github mayros ci cancel owner/repo 12345 mayros ci logs owner/repo 12345
Related
- Architecture — extension model and Cortex integration