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
       gh-agent-task(1)

                                   Oct 2025            GH-AGENT-TASK-CREATE(1)