Skip to main content

​
aether github

Manage the GitHub integration for your project. Connect your GitHub account, import repositories into workspaces, and export changes back to GitHub. Alias: gh

​
Usage

aether github <subcommand> [flags]

​
Subcommands

SubcommandDescription
connectConnect your GitHub account
disconnectDisconnect GitHub
statusShow GitHub connection status
reposList accessible repositories
importImport a repository into a workspace
exportExport workspace changes to GitHub
linkShow the linked repository
unlinkUnlink the repository from the project

​
aether github connect

Opens your browser to install the Aether GitHub App and authorize access to your repositories. 
aether github connect

Opening browser to connect GitHub...
Waiting for authorization...
GitHub connected as @username

​
aether github disconnect

Disconnect the GitHub integration from the current project. 
aether github disconnect [flags]
FlagDescription
--forceSkip confirmation prompt
aether github disconnect

Are you sure you want to disconnect GitHub? [y/N]

​
aether github status

Show the current GitHub connection status. 
aether github status

GitHub:     connected
Account:    @username
Linked:     owner/repo (main)

​
aether github repos

List repositories accessible through the GitHub App installation. 
aether github repos [flags]
FlagDescription
--pagePage number for pagination
--searchFilter repositories by name
aether github repos --search "api"

REPOSITORY              VISIBILITY    UPDATED
owner/backend-api       private       2025-01-15
owner/api-docs          public        2025-01-10

​
aether github import

Import a GitHub repository into a workspace. 
aether github import [flags]
FlagDescription
--repoRepository in owner/name format (required)
--workspaceTarget workspace ID. Uses the active workspace if not specified.
aether github import --repo owner/my-app

Importing owner/my-app into workspace ws_a1b2c3d4...
Import complete. 142 files synced.

aether github import --repo owner/my-app --workspace ws_e5f6g7h8

​
aether github export

Export workspace changes to GitHub as a commit. 
aether github export [flags]
FlagDescription
--workspaceWorkspace ID. Uses the active workspace if not specified.
--commit-messageCommit message for the push
--forceSkip confirmation prompt
aether github export --commit-message "fix: resolve login bug"

Exporting changes to owner/my-app...
Pushed 3 files to branch main.
Show the currently linked GitHub repository. 
aether github link

Linked repository: owner/my-app (branch: main)
Unlink the GitHub repository from the current project. This does not delete any files in the workspace. 
aether github unlink [flags]
FlagDescription
--forceSkip confirmation prompt
aether github unlink

Are you sure you want to unlink owner/my-app? Files in the workspace will not be deleted. [y/N]