Skip to content
Core ConceptsCLI ReferenceAPI Reference
Task
AGH RuntimeTask

agh task promote

Promote one network thread message into a task

Audience
Operators running durable agent work
Focus
Task guidance shaped for scanability, day-two clarity, and operator context.

agh task promote

Promote one network thread message into a task

agh task promote [flags]

Options

      --channel string          Source network channel
      --description string      Optional task description
  -h, --help                    help for promote
      --metadata string         Optional JSON metadata for the promoted task
      --origin-message string   Origin message id to promote
      --priority string         Optional task priority
      --thread string           Source public thread id
      --title string            Optional task title
      --workspace string        Workspace path, name, or ID

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every AGH command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Example:

agh task promote -o json

agh task pause

Pause new runs for one task

agh task publish

Publish a draft task and enqueue its first run

On this page

agh task promoteOptionsOptions inherited from parent commandsOutput Formats