Git workflows
| 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
| Flag | Type | Default | 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 |
Associate an existing PR with a session
polygraph git associate-pr
| Flag | Type | Default | 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 | Default | 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 | Default | 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 | Default | 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 | Default | Description |
|---|
--help, -h | boolean | | Show help for the current command |
--version | boolean | | Show the version number for the CLI |
--job | number | | |
--repo | string | | |