GH-AGENT-TASK-CREATE(1) | GitHub CLI manual | GH-AGENT-TASK-CREATE(1) |
NAME
gh-agent-task-create - Create an agent task (preview)
SYNOPSIS
gh agent-task create [<task description>] [flags]
OPTIONS
- -b, --base <string>
- Base branch for the pull request (use default branch if not provided)
- --follow
- Follow agent session logs
- -F, --from-file <file>
- Read task description from file (use "-" to read from standard input)
- -R, --repo <[HOST/]OWNER/REPO>
- Select another repository using the [HOST/]OWNER/REPO format
EXIT CODES
0: Successful execution
1: Error
2: Command canceled
4: Authentication required
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.
EXAMPLE
# Create a task from an inline description $ gh agent-task create "build me a new app" # Create a task from an inline description and follow logs $ gh agent-task create "build me a new app" --follow # Create a task from a file $ gh agent-task create -F task-desc.md # Create a task with problem statement from stdin $ echo "build me a new app" | gh agent-task create -F - # Create a task with an editor $ gh agent-task create # Create a task with an editor and a file as a template $ gh agent-task create -F task-desc.md # Select a different base branch for the PR $ gh agent-task create "fix errors" --base branch
SEE ALSO
Oct 2025 |