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



NAME
       gh-agent-task - Work with agent tasks (preview)



SYNOPSIS
       gh agent-task <command> [flags]



DESCRIPTION
       Working with agent tasks in the GitHub CLI is in preview and subject to
       change without notice.



AVAILABLE COMMANDS
       gh-agent-task-create(1)
              Create an agent task (preview)


       gh-agent-task-list(1)
              List agent tasks (preview)


       gh-agent-task-view(1)
              View an agent task session (preview)



ALIASES
       gh agent-tasks, gh agent, gh agents



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
       # List your most recent agent tasks
       $ gh agent-task list

       # Create a new agent task on the current repository
       $ gh agent-task create "Improve the performance of the data processing pipeline"

       # View details about agent tasks associated with a pull request
       $ gh agent-task view 123

       # View details about a specific agent task
       $ gh agent-task view 12345abc-12345-12345-12345-12345abc




SEE ALSO
       gh(1)

                                   Oct 2025                   GH-AGENT-TASK(1)