OS Manuals

gh-agent-task(1)

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

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

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

gh agent-task <command> [flags]

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

Create an agent task (preview)

List agent tasks (preview)

View an agent task session (preview)

gh agent-tasks, gh agent, gh agents

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.

# 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

gh(1)

Oct 2026

gh 2.102.0-r2 · os · ingested 2026-10-10