ax integrations
GitHub integration status and repo-to-experiment links.
Connect the GitHub App and link repos to experiments so !ax run works on
pull requests; see GitHub CI for the full workflow. Requires
credentials from ax auth login (or AX_API_KEY).
| Command | Use |
|---|---|
integrations list | Integration kinds and status for the org. |
integrations gh connect | Install/connect the GitHub App. |
integrations gh list | Connected repos and their experiment links. |
integrations gh link | Point a repo's PRs at an experiment. |
All commands accept --org <org-id>; list commands also accept --json.
integrations list
List integration kinds (github, llm-provider) with status and detail
counts.
ax integrations listintegrations gh connect
Open the org's integrations settings page to install or connect the GitHub App (the install flow is browser-only).
ax integrations gh connect [--no-browser]integrations gh list
List repos the org can see through a GitHub App installation, plus persisted
experiment links whose repos are no longer reachable (for example after an
uninstall). One row per repo: installation, repo, and the linked experiment
(a stored id, path:<repo-relative-path>, or (unlinked)).
ax integrations gh listintegrations gh link
Point !ax run on a repo's PRs at an experiment: either a stored
experiment (register it with ax experiment push
first) or a YAML in the repo itself, read at each PR's head commit.
Re-linking a repo overwrites its target.
ax integrations gh link <EXPERIMENT_ID> <owner/repo>
ax integrations gh link --path <repo-relative-path> <owner/repo>| Argument / flag | What it does |
|---|---|
<EXPERIMENT_ID> | Stored experiment id to run on the repo's PRs. Omit when using --path. |
<owner/repo> | Required. Target repository. |
--path <repo-relative-path> | Link an experiment YAML committed in the repo (e.g. .axp/experiment.yaml) instead of a stored id. |
Examples:
# Run a stored experiment on acme/webapp's PRs
ax integrations gh link my-experiment acme/webapp
# Run the YAML committed in the repo itself, read at each PR's head commit
ax integrations gh link --path .axp/experiment.yaml acme/webapp