import (a set-once binding); link only shows what is already linked.
Alias: gh
Usage
Subcommands
aether github connect
Prints the Aether GitHub App installation URL, attempts to open it in your browser, then polls until the installation is connected (up to 5 minutes). The URL is always printed, including in a non-TTY shell.--link, nothing opens and nothing waits: it prints a single-use link to the install page, for a machine with no browser, such as your Aether agent’s. The link works once, for ten minutes, opened by you signed in to Aether, and only an account with a verified phone (Settings → Your agent → Phone) is sent one. Check the outcome afterwards with aether github status.
aether github status
Show whether GitHub is connected and list each installation.GitHub: not connected and points you to aether github connect.
aether github repos
List repositories accessible through a GitHub App installation.
Run
aether github status to find your installation IDs. The output lists REPO, PRIVATE, DEFAULT BRANCH, and UPDATED; when more results exist the command tells you which --page to request next.
aether github import
Import a GitHub repository into a project. This is the set-once repo binding for the project — see GitHub integration. Only an owner or admin of the project’s organization can import, and through an installation only with push access to the repository: every owner, admin, member and viewer of the organization will be able to read its code. Anyone else is refused with 403org_role_insufficient.
Omit
--repo to choose a repository from a picker. The picker needs --installation-id so it can list that installation’s repos:
aether github link
Show the repository currently linked to a project. This command is read-only — it does not select or change the link. Link a repo withaether github import.
aether github tree
Fetch the linked repository’s git tree at a ref. The output lists each entry’sTYPE, PATH, and SHA.