Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 pro-
	    vided)

     -a, --custom-agent <string>
	    Use a custom agent for the task. e.g., use 'my-agent' for  the  'my-
	    agent.md' agent

     --follow
	    Follow agent session logs

     -F, --from-file <file>
	    Read  task	description from file (use "-" to read from standard in-
	    put)

     -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  com-
     mand'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

     # Create a task using the custom agent defined in '.github/agents/my-agent.md'
     $ gh agent-task create "build me a new app" --custom-agent my-agent

SEE ALSO
     gh-agent-task(1)

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

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-agent-task-create&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help