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
agentuity git link [options]
Options
| Option |
Type |
Required |
Default |
Description |
--repo |
string |
Yes |
- |
Repository full name (owner/repo) to link |
--deploy |
boolean |
Yes |
- |
Enable automatic deployments on push (default: true) |
--preview |
boolean |
Yes |
- |
Enable preview deployments on pull requests (default: true) |
--branch |
string |
Yes |
- |
Branch to deploy from (default: repo default branch) |
--root |
string |
Yes |
- |
Root directory containing agentuity.json (default: .) |
--confirm |
boolean |
Yes |
- |
Skip confirmation prompts |
Examples
Link current project to a GitHub repository:
bunx @agentuity/cli git link
Link to a specific repo non-interactively:
bunx @agentuity/cli git link --repo owner/repo --branch main --confirm
Link from the current directory:
bunx @agentuity/cli git link --root .
Link to a specific branch:
bunx @agentuity/cli git link --branch main
Enable preview deployments on PRs:
bunx @agentuity/cli git link --preview true
Disable automatic deployments on push:
bunx @agentuity/cli git link --deploy false
Link a subdirectory in a monorepo:
bunx @agentuity/cli git link --root packages/my-agent
Link and return JSON result:
bunx @agentuity/cli --json git link --repo owner/repo --branch main --confirm
Output
Returns JSON object:
{
"linked": "boolean",
"repoFullName": "string",
"branch": "string"
}
| Field |
Type |
Description |
linked |
boolean |
Whether the project was linked |
repoFullName |
string |
Repository that was linked |
branch |
string |
Branch configured |