Documentation Index
Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
Use this file to discover all available pages before exploring further.
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
| Subcommand | Description |
|---|
connect | Connect your GitHub account |
disconnect | Disconnect GitHub |
status | Show GitHub connection status |
repos | List accessible repositories |
import | Import a repository into a workspace |
export | Export workspace changes to GitHub |
link | Show the linked repository |
unlink | Unlink the repository from the project |
aether github connect
Opens your browser to install the Aether GitHub App and authorize access to your repositories.
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]
| Flag | Description |
|---|
--force | Skip confirmation prompt |
Are you sure you want to disconnect GitHub? [y/N]
aether github status
Show the current GitHub connection status.
GitHub: connected
Account: @username
Linked: owner/repo (main)
aether github repos
List repositories accessible through the GitHub App installation.
aether github repos [flags]
| Flag | Description |
|---|
--page | Page number for pagination |
--search | Filter 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]
| Flag | Description |
|---|
--repo | Repository in owner/name format (required) |
--workspace | Target 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]
| Flag | Description |
|---|
--workspace | Workspace ID. Uses the active workspace if not specified. |
--commit-message | Commit message for the push |
--force | Skip confirmation prompt |
aether github export --commit-message "fix: resolve login bug"
Exporting changes to owner/my-app...
Pushed 3 files to branch main.
aether github link
Show the currently linked GitHub repository.
Linked repository: owner/my-app (branch: main)
aether github unlink
Unlink the GitHub repository from the current project. This does not delete any files in the workspace.
aether github unlink [flags]
| Flag | Description |
|---|
--force | Skip confirmation prompt |
Are you sure you want to unlink owner/my-app? Files in the workspace will not be deleted. [y/N]
