> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staging.alpic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# git connect

> Connect a linked Alpic project to a git remote source

Links an Alpic project to a GitHub remote repository. Once connected, you can install the Alpic GitHub App to trigger automatic deployments on every push.

<Note>
  The directory must already be linked to an Alpic project (via `alpic deploy`) and must be a git repository with at
  least one GitHub remote configured.
</Note>

## Usage

```bash theme={null}
alpic git connect
```

Detects GitHub remotes in the current directory and prompts to select one.

## Extended Usage

```bash theme={null}
# Auto-select the only available remote without prompting
alpic git connect --non-interactive

# Connect using a specific named remote
alpic git connect --remote-name origin
```

## Options

| Flag                | Description                                                | Default |
| ------------------- | ---------------------------------------------------------- | ------- |
| `--non-interactive` | Automatically select the remote when only one is available | `false` |
| `--remote-name`     | Name of the remote to connect                              |         |