GH-AGENT-TASK-CREATE(1)        GitHub CLI manual       GH-AGENT-TASK-CREATE(1)



<?><?><?> (NAME)
       gh-agent-task-create - <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> (<?><?><?><?><?><?><?><?><?>)



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh agent-task create [<task description>] [flags]



<?><?><?><?><?><?><?><?> (OPTIONS)
       -b, --base <string>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>)


       -a, --custom-agent <string>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> 'my-agent'
              <?><?><?><?> <?><?><?><?><?> 'my-agent.md'


       --follow
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>


       -F, --from-file <file>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> -
              <?><?><?><?><?><?><?> <?><?><?><?>)


       -R, --repo <[HOST/]OWNER/REPO>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> [HOST/]OWNER/REPO



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       $ gh agent-task create "build me a new app"

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       $ gh agent-task create "build me a new app" --follow

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       $ gh agent-task create -F task-desc.md

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> stdin
       $ echo "build me a new app" | gh agent-task create -F -

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       $ gh agent-task create

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       $ gh agent-task create -F task-desc.md

       # <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> PR
       $ gh agent-task create "fix errors" --base branch

       # <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> '.github/agents/my-agent.md'
       $ gh agent-task create "build me a new app" --custom-agent my-agent




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-agent-task(1)

                                   Sep 2026            GH-AGENT-TASK-CREATE(1)