The --create-pull-request flag (or --pr) creates a pull request with the workflow changes.
...
Flags:
      --create-pull-request        Create a pull request with the workflow changes
```

**Issue**: The long description explicitly says `(or --pr)`, but `--pr` is registered as a hidden flag (`MarkHidden` in `pkg/cli/add_command.go` line 137) and therefore does not appear in the flags list. Users who read the description and look for `--pr` in the flags will be confused when they don't find it.

**Suggested Fix**: Either:
- Remove the `(or --pr)` reference from the Long description (since the flag is intentionally hidden), **or**
- Unhide `--pr` so it appears in the flags list alongside `--create-pull-request`

---

#### 2. `trial` — `--repo` flag has different semantics from all other commands

**Command Affected**: `gh aw trial`
**Priority**: Medium
**Type**: Semantic inconsistency across commands

**Current output** (from `./gh-aw trial --help`):
```
--repo string   Alias for --host-repo: the repository where workflows are installed and run
                (note: different semantics from --repo in other commands)
```

**Contrast with every other command** (e.g., `gh aw audit --help`, `gh aw logs --help`, `gh aw status --help`):
```
-r, --repo string   Target repository ([HOST/]owner/repo format). Defaults to current repository
```

**Issue**: In all other commands, `--repo` means "the remote repository to read from or operate on." In `trial`, `--repo` is an alias for `--host-repo` meaning "the repository where workflows are installed and run." The help text acknowledges this conflict with the note `(note: different semantics from --repo in other commands)`, but the inconsistency itself remains and can cause user errors — e.g., a user familiar with `gh aw logs --repo owner/repo` may expect `gh aw trial --repo owner/repo` to have the same read-target semantics.

**Source**: `pkg/cli/trial_command.go` line 184.

**Suggested Fix**: Consider renaming `--repo` in `trial` to only `--host-repo` (deprecate/remove the `--repo` alias), or add a prominent warning when `--repo` is used in `trial` mode to help users catch this distinction.

---

#### 3. `audit` — Usage line shows `(run-id)` but command also accepts URLs

**Command Affected**: `gh aw audit`
**Priority**: Low
**Type**: Misleading Usage synopsis

**Current output** (from `./gh-aw audit --help`):
```
Usage:
  gh aw audit (run-id) [flags]