---

name: agentuity-cli-git-link description: Link a project to a GitHub repository. Requires authentication version: "0.1.11" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" metadata: command: "agentuity git link" tags: "mutating creates-resource"

Git Link

Link a project to a GitHub repository

Prerequisites

• Authenticated with agentuity auth login
• Project context required (run from project directory or use --project-id)

Usage

Copyagentuity git link [options]

Options

Examples

Link current project to a GitHub repository:

Copybunx @agentuity/cli git link

Link to a specific repo non-interactively:

Copybunx @agentuity/cli git link --repo owner/repo --branch main --confirm

Link from the current directory:

Copybunx @agentuity/cli git link --root .

Link to a specific branch:

Copybunx @agentuity/cli git link --branch main

Enable preview deployments on PRs:

Copybunx @agentuity/cli git link --preview true

Disable automatic deployments on push:

Copybunx @agentuity/cli git link --deploy false

Link a subdirectory in a monorepo:

Copybunx @agentuity/cli git link --root packages/my-agent

Link and return JSON result:

Copybunx @agentuity/cli --json git link --repo owner/repo --branch main --confirm

Output

Returns JSON object:

Copy{
  "linked": "boolean",
  "repoFullName": "string",
  "branch": "string"
}