Skip to content
Core ConceptsCLI ReferenceAPI Reference
NetworkThreads
AGH RuntimeNetwork

agh network threads promote

Promote one thread message into a durable task

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

agh network threads promote

Promote one thread message into a durable task

agh network threads promote [flags]

Options

      --channel string          Target 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           Public thread id
      --title string            Optional task title

Options inherited from parent commands

      --json               Emit JSON output
  -o, --output string      Output format: human, json, jsonl, or toon (default "human")
      --workspace string   Workspace root, name, or ID for scoped network data

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 network threads promote -o json

agh network threads messages

List messages in one public thread

agh network threads show

Show one public thread

On this page

agh network threads promoteOptionsOptions inherited from parent commandsOutput Formats