> ## 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

> Connect and sync with GitHub repositories

# 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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
aether github disconnect [flags]
```

| Flag      | Description              |
| --------- | ------------------------ |
| `--force` | Skip confirmation prompt |

```bash theme={null}
aether github disconnect
```

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

## aether github status

Show the current GitHub connection status.

```bash theme={null}
aether github status
```

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

## aether github repos

List repositories accessible through the GitHub App installation.

```bash theme={null}
aether github repos [flags]
```

| Flag       | Description                 |
| ---------- | --------------------------- |
| `--page`   | Page number for pagination  |
| `--search` | Filter repositories by name |

```bash theme={null}
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.

```bash theme={null}
aether github import [flags]
```

| Flag          | Description                                                      |
| ------------- | ---------------------------------------------------------------- |
| `--repo`      | Repository in `owner/name` format (required)                     |
| `--workspace` | Target workspace ID. Uses the active workspace if not specified. |

```bash theme={null}
aether github import --repo owner/my-app
```

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

```bash theme={null}
aether github import --repo owner/my-app --workspace ws_e5f6g7h8
```

## aether github export

Export workspace changes to GitHub as a commit.

```bash theme={null}
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                                  |

```bash theme={null}
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.

```bash theme={null}
aether github link
```

```
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.

```bash theme={null}
aether github unlink [flags]
```

| Flag      | Description              |
| --------- | ------------------------ |
| `--force` | Skip confirmation prompt |

```bash theme={null}
aether github unlink
```

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