> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Actions CLI

> Trigger GitHub Actions workflow_dispatch runs and list workflows in a repository from Paradime Bolt using the paradime run github-actions CLI commands.

The Paradime SDK provides CLI commands to interact with GitHub Actions, allowing you to trigger workflow dispatches and list available workflows in a repository.

### Trigger Workflow Dispatches

Trigger GitHub Actions workflow dispatches for one or more workflows, optionally waiting for the runs to complete.

```bash theme={"system"}
paradime run github-actions-trigger \
  --workflow-ids "ci.yml"
```

**Options**

| Flag                   | Type              | Description                                                                                                                                |
| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `--token`              | Required, TEXT    | GitHub personal access token or fine-grained token. Can be set via `GITHUB_TOKEN` environment variable.                                    |
| `--repo`               | Required, TEXT    | GitHub repository in 'owner/repo' format. Can be set via `GITHUB_REPOSITORY` environment variable.                                         |
| `--workflow-ids`       | Required, TEXT    | Comma-separated workflow ID(s) or filenames to trigger.                                                                                    |
| `--ref`                | Optional, TEXT    | Git reference (branch/tag) to trigger the workflow on. Default: `main`.                                                                    |
| `--inputs`             | Optional, TEXT    | JSON string of workflow inputs (optional).                                                                                                 |
| `--wait` / `--no-wait` | Optional, Flag    | Wait for workflow runs to complete before returning. Default: `--wait`. Can be set via `GITHUB_ACTIONS_TRIGGER_WAIT` environment variable. |
| `--timeout`            | Optional, INTEGER | Maximum time to wait in minutes. Default: 1440. Can be set via `GITHUB_ACTIONS_TRIGGER_TIMEOUT` environment variable.                      |
| `--json`               | Optional, Flag    | Output results as JSON. Default: `False`.                                                                                                  |
| `--help`               |                   | Show CLI command options and exit.                                                                                                         |

**Example**

```bash theme={"system"}
paradime run github-actions-trigger \
  --repo "my-org/my-repo" \
  --workflow-ids "build.yml,deploy.yml" \
  --ref "release" \
  --inputs '{"environment": "production"}'
```

### List Workflows

List all GitHub Actions workflows in a repository.

```bash theme={"system"}
paradime run github-actions-list
```

**Options**

| Flag      | Type           | Description                                                                                             |
| --------- | -------------- | ------------------------------------------------------------------------------------------------------- |
| `--token` | Required, TEXT | GitHub personal access token or fine-grained token. Can be set via `GITHUB_TOKEN` environment variable. |
| `--repo`  | Required, TEXT | GitHub repository in 'owner/repo' format. Can be set via `GITHUB_REPOSITORY` environment variable.      |
| `--json`  | Optional, Flag | Output results as JSON. Default: `False`.                                                               |
| `--help`  |                | Show CLI command options and exit.                                                                      |


## Related topics

- [Github Actions to Paradime Bolt](/guides/migrations/migrating-dbt-tm-jobs-from-github-actions-to-paradime-bolt.md)
- [GitHub PR Management Tool](/products/dino-ai/tools-and-features/github-pr-management-tool.md)
- [GitHub Merge Queue](/guides/working-with-git/github-merge-queue.md)
- [GitHub](/products/bolt/ci-cd/turbo-ci/github.md)
- [GitHub Issues Backlog Agent](/guides/programmable-agents/github-issues-backlog-agent.md)