# atmos pro commit

Use this command to commit staged changes via the [Atmos Pro](https://atmos-pro.com/docs) GitHub App.
Unlike commits made with `GITHUB_TOKEN`, commits created through Atmos Pro trigger subsequent CI runs.

## Usage

```shell
atmos pro commit --message <message> [--comment <comment>] [--add <pattern>] [--all]
```

## Description

When running in GitHub Actions, commits made with `GITHUB_TOKEN` do not trigger subsequent workflow runs.
This is a deliberate GitHub limitation to prevent infinite loops, but it also prevents autofix workflows
(like `terraform fmt`) from triggering validation on the reformatted code.

`atmos pro commit` solves this by sending your changes to Atmos Pro, which creates the commit server-side
using its GitHub App installation. Because the commit comes from the app (not `GITHUB_TOKEN`), GitHub
triggers CI normally.

The workflow never receives a write token. Atmos Pro controls exactly what gets committed.

:::info Loop Prevention
The command automatically detects when it's running in a workflow triggered by `atmos-pro[bot]` and
exits early with a success message. This prevents infinite commit loops without requiring any workflow
configuration. You can optionally add `if: github.actor != 'atmos-pro[bot]'` to skip the entire job
for efficiency.
:::

## Examples

```shell
# Commit whatever is already staged
atmos pro commit -m "terraform fmt"

# Stage all changes then commit
atmos pro commit -m "terraform fmt" --all

# Stage only .tf files then commit
atmos pro commit -m "terraform fmt" --add "*.tf"

# Include a PR comment alongside the commit
atmos pro commit -m "terraform fmt" --comment "Auto-formatted Terraform files"
```

### Example GitHub Actions Workflow

```yaml
name: autocommit
on: pull_request

permissions:
  contents: read
  id-token: write

jobs:
  format:
    if: github.actor != 'atmos-pro[bot]'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - run: terraform fmt -recursive
      - run: atmos pro commit -m "[autocommit] terraform fmt" --all
```

## Flags

- **`--message` (alias `-m`) (required)** — Commit message. Maximum 500 characters.
- **`--comment` (optional)** — PR comment to post alongside the commit. Maximum 2000 characters.
- **`--add` (optional)** — File pattern to stage before committing (e.g. `"*.tf"`). Runs `git add <pattern>`. Mutually exclusive with `--all`.
- **`--all` (alias `-A`) (optional)** — Stage all changes before committing (runs `git add -A`). Mutually exclusive with `--add`.

## Environment Variables

- **`ATMOS_PRO_BASE_URL`** — Atmos Pro API URL (e.g. `https://app.atmos.pro`). Can also be set in `atmos.yaml`.
- **`ATMOS_PRO_WORKSPACE_ID`** — Workspace ID for OIDC authentication.
- **`GITHUB_HEAD_REF`** — PR branch name. Set automatically by GitHub Actions on `pull_request` events. Required.
- **`ACTIONS_ID_TOKEN_REQUEST_URL`** — GitHub Actions OIDC token endpoint. Set automatically when `id-token: write` permission is granted.
- **`ACTIONS_ID_TOKEN_REQUEST_TOKEN`** — GitHub Actions OIDC request bearer token. Set automatically when `id-token: write` permission is granted.