polygraph git

Git workflows

polygraph git

Options

Flag	Type	Default	Description
`--help`, `-h`	`boolean`		Show help for the current command
`--version`	`boolean`		Show the version number for the CLI

Create PRs from a spec file

polygraph git create-pr

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--description`	`string`	Session description for handoff context (required; pass "none" to skip the update)
`--agent-session-id`	`string`	Agent session ID to save with the session
`--spec-file`	`string`	Path to PR spec JSON file

Update metadata on a session pull request

polygraph git update-pr

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--pr-url`	`string`	Associated PR URL to update
`--title`	`string`	Replace the PR title
`--body`	`string`	Replace the PR body. Pass an empty string to clear it
`--set-label`	`array<string>`	Replace all labels. Repeat for multiple labels; use --clear-labels for none
`--clear-labels`	`boolean`	Remove all labels
`--add-label`	`array<string>`	Add a label. Repeat for multiple labels
`--remove-label`	`array<string>`	Remove a label. Repeat for multiple labels
`--set-assignee`	`array<string>`	Replace all assignees. Repeat for multiple assignees; use --clear-assignees for none
`--clear-assignees`	`boolean`	Remove all assignees
`--add-assignee`	`array<string>`	Add an assignee. Repeat for multiple assignees
`--remove-assignee`	`array<string>`	Remove an assignee. Repeat for multiple assignees

Associate an existing PR with a session

polygraph git associate-pr

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--description`	`string`	Session description for handoff context (required; pass "none" to skip the update)
`--agent-session-id`	`string`	Agent session ID to save with the session
`--pr-url`	`string`	PR URL to associate
`--branch`	`string`	Branch name to associate by
`--repo`, `-r`	`string`	Repository (ID, full name, or short name)

Mark one or more PRs ready for review

polygraph git mark-pr-ready

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--agent-session-id`	`string`	Agent session ID to save with the session
`--pr-url`	`array<string>`	PR URL(s) to mark ready

Push the current branch for a session repository

polygraph git push-branch [repo] [branch]

Name	Type	Description
`repo`	`string`	Repository (ID, full name, or short name)
`branch`	`string`	Branch name to push

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--description`	`string`	Session description for handoff context (required; pass "none" to skip the update)
`--agent-session-id`	`string`	Agent session ID to save with the session

Fetch more commit history for a session repository

polygraph git fetch [repo]

Name	Type	Description
`repo`	`string`	Repository (ID, full name, or short name)

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--session`, `-s`	`string`	Session ID (auto-detects from cwd if omitted)
`--depth`	`number`	Fetch the newest N commits per ref instead of the full history
`--ref`	`array<string>`	Additional remote branch(es) to fetch (repeatable)

Fetch and print the log for a CI job in a session

polygraph git ci-logs [session]

Name	Type	Description
`session`	`string`	Session ID (auto-detects from cwd if omitted)

Flag	Type	Description
`--help`, `-h`	`boolean`	Show help for the current command
`--version`	`boolean`	Show the version number for the CLI
`--job`	`number`
`--repo`	`string`