FreeBSD Manual Pages
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 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 # 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) Mar 2026 GH-AGENT-TASK-CREATE(1)
NAME | SYNOPSIS | OPTIONS | EXIT CODES | EXAMPLE | SEE ALSO
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.0.quarterly>