CLI Commands

Source: Hypertask CLI hypertask 0.2.20 (zig).

186 commands. Run any command with --help for its current usage.

`hypertask`

hypertask 0.2.0 (zig), native Hypertask CLI

Usage: hypertask [--json] [--token <jwt>] [--api-url <url>] <command> ...

Run `hypertask capabilities --json` for the complete command and option catalog.

AI agents: run `hypertask feedback --category call_failed` on your own when a hypertask command fails unexpectedly. Free text (note and error) is not stored; agents should pick a category. Never include task, board or comment content.
Unexpected failures send command name and error type only, no task content; disable with HYPERTASK_NO_ERROR_REPORTS=1 or error_reports=false in ~/.hypertask/config.json.

`hypertask admin`

Manage administrative resources

Usage: hypertask admin <command>

Commands:
  keys
      List, create, and revoke management keys
  agents
      List, create, revoke, delete, and rotate managed agents
  tokens
      Mint and revoke account MCP tokens
  connections
      Inspect OAuth connections

Example:
  hypertask admin keys list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin agents`

List, create, revoke, delete, and rotate managed agents

Usage: hypertask admin agents <command>

Commands:
  list
      List managed agents
  create
      Create an agent and print its bearer token once
  revoke
      Revoke an agent and invalidate its bearer token
  delete
      Permanently delete a managed agent
  rotate-token
      Rotate an agent bearer token and print the replacement once

Example:
  hypertask admin agents list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin agents create`

Create an agent and print its bearer token once

Usage: hypertask admin agents create [options]

Options:
  --name <display_name> (required)
      Agent display name
  --project <id>
      Project ID (repeatable)
  --role <role>
      Agent role
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin agents create --name <display_name>

  -h, --help
      Show help

`hypertask admin agents delete`

Permanently delete a managed agent

Usage: hypertask admin agents delete [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --confirm
      Confirm permanent deletion
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin agents delete --id <agent_id>

  -h, --help
      Show help

`hypertask admin agents list`

List managed agents

Usage: hypertask admin agents list [options]

Options:
  --management-key <htmk>
      Management key for this request
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask admin agents list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin agents revoke`

Revoke an agent and invalidate its bearer token

Usage: hypertask admin agents revoke [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin agents revoke --id <agent_id>

  -h, --help
      Show help

`hypertask admin agents rotate-token`

Rotate an agent bearer token and print the replacement once

Usage: hypertask admin agents rotate-token [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin agents rotate-token --id <agent_id>

  -h, --help
      Show help

`hypertask admin connections`

Inspect OAuth connections

Usage: hypertask admin connections <command>

Commands:
  list
      List OAuth connections

Example:
  hypertask admin connections list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin connections list`

List OAuth connections

Usage: hypertask admin connections list [options]

Options:
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin connections list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin keys`

List, create, and revoke management keys

Usage: hypertask admin keys <command>

Commands:
  list
      List management keys
  create
      Create a management key and print it once
  revoke
      Revoke a management key

Example:
  hypertask admin keys list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin keys create`

Create a management key and print it once

Usage: hypertask admin keys create [options]

Options:
  --name <name> (required)
      Management key name
  --scope <scope>
      Key scope
  --expires-in-days <n>
      Expiry in days (1-365)
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin keys create --name <name>

  -h, --help
      Show help

`hypertask admin keys list`

List management keys

Usage: hypertask admin keys list [options]

Options:
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin keys list --management-key <htmk>

  -h, --help
      Show help

`hypertask admin keys revoke`

Revoke a management key

Usage: hypertask admin keys revoke <keyId> [options]

Options:
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin keys revoke <keyId> --management-key <htmk>

  -h, --help
      Show help

`hypertask admin tokens`

Mint and revoke account MCP tokens

Usage: hypertask admin tokens <command>

Commands:
  mint
      Mint an account MCP token and print it once
  revoke
      Revoke one or all account MCP tokens

Example:
  hypertask admin tokens mint --expires-in-days <n>

  -h, --help
      Show help

`hypertask admin tokens mint`

Mint an account MCP token and print it once

Usage: hypertask admin tokens mint [options]

Options:
  --expires-in-days <n>
      Expiry in days (1-365)
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin tokens mint --expires-in-days <n>

  -h, --help
      Show help

`hypertask admin tokens revoke`

Revoke one or all account MCP tokens

Usage: hypertask admin tokens revoke [options]

Options:
  --account-token <jwt>
      Signed account MCP token to revoke
  --all
      Revoke all account MCP tokens
  --management-key <htmk>
      Management key for this request

Example:
  hypertask admin tokens revoke --account-token <jwt>

  -h, --help
      Show help

`hypertask agent`

Run ticket operations as the managed agent identified by the active bearer token

Usage: hypertask agent <command>

Commands:
  say
      Post a comment as the active agent and record it as seen
  take
      Assign the active agent to a ticket under a mutation lease
  drop
      Unassign the active agent from a ticket under a mutation lease
  move
      Move a ticket as the active agent
  poll
      Print unseen comments that mention the active agent
  new-tickets
      Print in-scope tickets not recorded by an earlier pass
  hand
      Replace the active agent with another managed agent under a mutation lease
  dev
      Point an agent's webhook at a tunnel to this machine for one session, then put the old URL back
  replay
      Re-send a recorded run's webhook deliveries to a handler running on this machine

Example:
  hypertask agent say <ticket> <html> --project <id>

  -h, --help
      Show help

`hypertask agent dev`

Point an agent's webhook at a tunnel to this machine for one session, then put the old URL back

Usage: hypertask agent dev [options]

Options:
  --agent <id> (required)
      Agent whose webhook is borrowed; never defaults to self
  --port <port> (required)
      Local port the agent handler listens on
  --path <path>
      Path appended to the tunnel URL (default /)
  --tunnel-url <url>
      Use an existing public https tunnel instead of starting cloudflared

Example:
  hypertask agent dev --agent <id> --port <port>

  -h, --help
      Show help

`hypertask agent drop`

Unassign the active agent from a ticket under a mutation lease

Usage: hypertask agent drop <ticket> [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)

Example:
  hypertask agent drop <ticket> --project <id>

  -h, --help
      Show help

`hypertask agent hand`

Replace the active agent with another managed agent under a mutation lease

Usage: hypertask agent hand <ticket> <target-agent-id> [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)
  --add
      Keep existing agent assignees instead of replacing them

Example:
  hypertask agent hand <ticket> <target-agent-id> --project <id>

  -h, --help
      Show help

`hypertask agent move`

Move a ticket as the active agent

Usage: hypertask agent move <ticket> <section> [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)

Example:
  hypertask agent move <ticket> <section> --project <id>

  -h, --help
      Show help

`hypertask agent new-tickets`

Print in-scope tickets not recorded by an earlier pass

Usage: hypertask agent new-tickets [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)
  --label <name>
      Only include tickets carrying this label

Example:
  hypertask agent new-tickets --project <id>

  -h, --help
      Show help

`hypertask agent poll`

Print unseen comments that mention the active agent

Usage: hypertask agent poll [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)
  --agent-id <id>
      Managed agent ID used for mention matching (or HT_AGENT_ID)
  --agent-name <name>
      Managed agent display name used for mention matching (or HT_AGENT_NAME)
  --all
      Print all unseen comments instead of addressed comments only

Example:
  hypertask agent poll --project <id>

  -h, --help
      Show help

`hypertask agent replay`

Re-send a recorded run's webhook deliveries to a handler running on this machine

Usage: hypertask agent replay <run-id> [options]

Options:
  --url <url> (required)
      Local handler URL, for example http://localhost:3000/
  --agent <id>
      Agent whose recorded deliveries are read (default self)

Example:
  hypertask agent replay <run-id> --url <url>

  -h, --help
      Show help

`hypertask agent say`

Post a comment as the active agent and record it as seen

Usage: hypertask agent say <ticket> <html> [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)

Example:
  hypertask agent say <ticket> <html> --project <id>

  -h, --help
      Show help

`hypertask agent take`

Assign the active agent to a ticket under a mutation lease

Usage: hypertask agent take <ticket> [options]

Options:
  --project <id>
      Project ID (or HT_AGENT_PROJECT_ID)
  --slug <slug>
      Agent slug used by capability scope checks (or HT_AGENT_SLUG)
  --state-dir <path>
      Directory for durable seen and poll state (or HT_AGENT_STATE_DIR)

Example:
  hypertask agent take <ticket> --project <id>

  -h, --help
      Show help

`hypertask agents`

Manage agents and their signed webhooks

Usage: hypertask agents <command>

Commands:
  list
      List managed agents
  get
      Show one managed agent's mission text, boards, created_at, and revoked state
  create
      Create an agent and print its bearer token once
  update
      Rename an agent, change visibility, or add/remove it from projects
  revoke
      Revoke an agent and invalidate its bearer token
  archive
      Archive an agent from normal agent lists
  delete
      Permanently delete a managed agent
  rename
      Rename an agent
  rotate-token
      Rotate an agent bearer token and print the replacement once
  webhook
      Manage signed mention and assignment webhooks for an agent

Example:
  hypertask agents list --management-key <htmk>

  -h, --help
      Show help

`hypertask agents archive`

Archive an agent from normal agent lists

Usage: hypertask agents archive [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents archive --id <agent_id>

  -h, --help
      Show help

`hypertask agents create`

Create an agent and print its bearer token once

Usage: hypertask agents create [options]

Options:
  --name <display_name> (required)
      Agent display name
  --project <id>
      Project ID (repeatable)
  --role <role>
      Agent role
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents create --name <display_name>

  -h, --help
      Show help

`hypertask agents delete`

Permanently delete a managed agent

Usage: hypertask agents delete [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --confirm
      Confirm permanent deletion
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents delete --id <agent_id>

  -h, --help
      Show help

`hypertask agents get`

Show one managed agent's mission text, boards, created_at, and revoked state

Usage: hypertask agents get [id] [options]

Options:
  --id <agent_id>
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents get --id <agent_id>

  -h, --help
      Show help

`hypertask agents list`

List managed agents

Usage: hypertask agents list [options]

Options:
  --management-key <htmk>
      Management key for this request
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --limit <n>
      Maximum rows to return
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask agents list --management-key <htmk>

  -h, --help
      Show help

`hypertask agents rename`

Rename an agent

Usage: hypertask agents rename [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --name <display_name> (required)
      New agent display name
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents rename --id <agent_id> --name <display_name>

  -h, --help
      Show help

`hypertask agents revoke`

Revoke an agent and invalidate its bearer token

Usage: hypertask agents revoke [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents revoke --id <agent_id>

  -h, --help
      Show help

`hypertask agents rotate-token`

Rotate an agent bearer token and print the replacement once

Usage: hypertask agents rotate-token [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents rotate-token --id <agent_id>

  -h, --help
      Show help

`hypertask agents update`

Rename an agent, change visibility, or add/remove it from projects

Usage: hypertask agents update [options]

Options:
  --id <agent_id> (required)
      Agent ID
  --name <display_name>
      New agent display name; the only change allowed when set
  --add-project <id>
      Project ID to add (repeatable)
  --remove-project <id>
      Project ID to remove (repeatable)
  --visibility <TEAM|PRIVATE>
      Agent visibility; the only change allowed per request
  --management-key <htmk>
      Management key for this request

Example:
  hypertask agents update --id <agent_id>

  -h, --help
      Show help

`hypertask agents webhook`

Manage signed mention and assignment webhooks for an agent

Usage: hypertask agents webhook <command>

Commands:
  get
      Show configuration, contract, and recent deliveries
  configure
      Create or update an agent webhook
  rotate-secret
      Rotate and print the signing secret once

Example:
  hypertask agents webhook get --agent <agent_id>

  -h, --help
      Show help

`hypertask agents webhook configure`

Create or update an agent webhook

Usage: hypertask agents webhook configure [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token
  --url <https_url>
      Public HTTPS receiver URL
  --project <id>
      Limit delivery to one board
  --all-boards
      Remove the board filter
  --event <name>
      Event name (repeatable)
  --enabled
      Enable delivery
  --disabled
      Disable delivery

Example:
  hypertask agents webhook configure --agent <agent_id>

  -h, --help
      Show help

`hypertask agents webhook get`

Show configuration, contract, and recent deliveries

Usage: hypertask agents webhook get [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask agents webhook get --agent <agent_id>

  -h, --help
      Show help

`hypertask agents webhook rotate-secret`

Rotate and print the signing secret once

Usage: hypertask agents webhook rotate-secret [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask agents webhook rotate-secret --agent <agent_id>

  -h, --help
      Show help

`hypertask ai`

Run the AI Task Writer, Write with AI, and text rewrites

Usage: hypertask ai <command>

Commands:
  write
      Draft or rewrite task content with the AI Task Writer
  improve
      Rewrite text with one of the editor's slash-menu AI commands

Example:
  hypertask ai write <prompt> --project <id>

  -h, --help
      Show help

`hypertask ai improve`

Rewrite text with one of the editor's slash-menu AI commands

Usage: hypertask ai improve [text] [options]

Options:
  --command <name>
      improve-readability (default), fix-spelling, summarize, make-shorter, or translate:<language> (e.g. translate:German)
  --project <id>
      Project ID (carries the team's AI settings)
  --task <ticket>
      Ticket to resolve the project from, e.g. HTPR-4650

Example:
  hypertask ai improve --command <name>

  -h, --help
      Show help

`hypertask ai write`

Draft or rewrite task content with the AI Task Writer

Usage: hypertask ai write <prompt> [options]

Options:
  --project <id>
      Project ID (defaults to the task's board)
  --task <ticket>
      Ticket to use as context, e.g. HTPR-4650
  --mode <task-writer|write-with-ai>
      task-writer drafts a description, write-with-ai drafts a comment
  --instructions <text>
      Extra custom instructions for this run
  --apply
      Write the result back to the task (requires --task)

Example:
  hypertask ai write <prompt> --project <id>

  -h, --help
      Show help

`hypertask capabilities`

Print a paste-ready command list (--json gives the full catalog with every option)

Usage: hypertask capabilities

Example:
  hypertask capabilities

  -h, --help
      Show help

`hypertask comment`

Manage comments

Usage: hypertask comment <command>

Commands:
  list
      List comments on a task. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  add
      Add comment to task
  react
      Add an emoji reaction to a comment
  unreact
      Remove your emoji reaction from a comment
  update
      Update comment
  delete
      Delete comment

Example:
  hypertask comment list <ticket-or-task-id> --project <id>

  -h, --help
      Show help

`hypertask comment add`

Add comment to task

Usage: hypertask comment add <ticket-or-task-id> [options]

Options:
  --project <id>
      Project ID; treats a numeric task reference as its board index
  --text <text>
      Comments and descriptions are HTML. Wrap content in block tags. Never embed images; attach files with --attach. Bare text is wrapped in paragraphs.
  --body <body>
      Alias for --text
  --file <path>
      Read comment text from file; use --markdown for Markdown
  --markdown
      Send the comment unchanged for server-side Markdown conversion
  --reply-to-comment-id <id>
      Invoking comment ID when an agent answers a direct comment mention
  --reply-to-invocation-id <id>
      Invocation notification ID when an agent answers a description mention
  --attach <path-or-url>
      Attach local file or http(s) URL to comment (repeatable)
  --improve
      Run the text through the AI writer before posting (default: improve-readability)
  --improve-command <name>
      Which AI rewrite to run with --improve: improve-readability (default), fix-spelling, summarize, make-shorter, or translate:<language>

Example:
  hypertask comment add <ticket-or-task-id> --project <id>

  -h, --help
      Show help

`hypertask comment delete`

Delete comment

Usage: hypertask comment delete <id>

Example:
  hypertask comment delete <id>

  -h, --help
      Show help

`hypertask comment list`

List comments on a task. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask comment list <ticket-or-task-id> [options]

Options:
  --project <id>
      Project ID; treats a numeric task reference as its board index
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --limit <n>
      Maximum rows to return
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask comment list <ticket-or-task-id> --project <id>

  -h, --help
      Show help

`hypertask comment react`

Add an emoji reaction to a comment

Usage: hypertask comment react <id> [options]

Options:
  --emoji <emoji> (required)
      Emoji to add

Example:
  hypertask comment react <id> --emoji <emoji>

  -h, --help
      Show help

`hypertask comment unreact`

Remove your emoji reaction from a comment

Usage: hypertask comment unreact <id> [options]

Options:
  --emoji <emoji> (required)
      Emoji to remove

Example:
  hypertask comment unreact <id> --emoji <emoji>

  -h, --help
      Show help

`hypertask comment update`

Update comment

Usage: hypertask comment update <id> [options]

Options:
  --text <text> (required)
      New comment text (plain text, Markdown or HTML; auto-converted to <p> blocks, blank line = paragraph break)

Example:
  hypertask comment update <id> --text <text>

  -h, --help
      Show help

`hypertask context`

Get user context, projects, and agent information

Usage: hypertask context

Example:
  hypertask context

  -h, --help
      Show help

`hypertask decision`

Create and resolve durable human decision requests

Usage: hypertask decision [ticket] [options] <command>

Options:
  --question <text>
      Question for legacy create grammar
  --option <value>
      Decision option for legacy create grammar (repeat two to ten times)

Commands:
  create
      Create a decision request for a task
  list
      List decision requests for a task
  get
      Get a decision request
  answer
      Answer a decision request (human tokens only)
  cancel
      Cancel a pending decision request

Example:
  hypertask decision create <ticket> --question <text>

  -h, --help
      Show help

`hypertask decision answer`

Answer a decision request (human tokens only)

Usage: hypertask decision answer <id> [options]

Options:
  --option <value> (required)
      Exact option returned by get/list
  --note <text>
      Optional note
  --confirm
      Confirm this final answer
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask decision answer <id> --option <value>

  -h, --help
      Show help

`hypertask decision cancel`

Cancel a pending decision request

Usage: hypertask decision cancel <id> [options]

Options:
  --confirm
      Confirm cancellation
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask decision cancel <id> --confirm

  -h, --help
      Show help

`hypertask decision create`

Create a decision request for a task

Usage: hypertask decision create <ticket> [options]

Options:
  --question <text> (required)
      Question for the human
  --option <value>
      Decision option (repeat two to ten times)
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask decision create <ticket> --question <text>

  -h, --help
      Show help

`hypertask decision get`

Get a decision request

Usage: hypertask decision get <id> [options]

Options:
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask decision get <id> --project <id>

  -h, --help
      Show help

`hypertask decision list`

List decision requests for a task

Usage: hypertask decision list <ticket-or-id> [options]

Options:
  --status <pending|answered|cancelled>
      Filter by status
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask decision list <ticket-or-id> --status <pending|answered|cancelled>

  -h, --help
      Show help

`hypertask draft`

Create and manage comment/description drafts for tasks

Usage: hypertask draft <command>

Commands:
  create
      Create a draft for a task. Add --comment to create draft for comment, else draft created for description.
  list
      List current draft(s) for a ticket
  update
      Update an existing draft
  publish
      Publish a draft — creates the actual comment or updates the task description from the draft
  delete
      Delete a draft

Example:
  hypertask draft create <ticket> --text <text>

  -h, --help
      Show help

`hypertask draft create`

Create a draft for a task. Add --comment to create draft for comment, else draft created for description.

Usage: hypertask draft create <ticket> [options]

Options:
  --text <text>
      Draft text (plain text or markdown; converted to HTML automatically)
  --comment
      If provided, draft is created for comment; otherwise description draft
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask draft create <ticket> --text <text>

  -h, --help
      Show help

`hypertask draft delete`

Delete a draft

Usage: hypertask draft delete <draft-id> [options]

Options:
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask draft delete <draft-id> --project <id>

  -h, --help
      Show help

`hypertask draft list`

List current draft(s) for a ticket

Usage: hypertask draft list <ticket> [options]

Options:
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask draft list <ticket> --project <id>

  -h, --help
      Show help

`hypertask draft publish`

Publish a draft — creates the actual comment or updates the task description from the draft

Usage: hypertask draft publish <draft-id> [options]

Options:
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask draft publish <draft-id> --project <id>

  -h, --help
      Show help

`hypertask draft update`

Update an existing draft

Usage: hypertask draft update <draft-id> [options]

Options:
  --text <text> (required)
      New draft text (plain text or markdown; converted to HTML automatically)
  --project <id>
      Project ID when the ticket prefix is ambiguous

Example:
  hypertask draft update <draft-id> --text <text>

  -h, --help
      Show help

`hypertask feedback`

File anonymous AI feedback. Free text (note and error) is not stored; agents should pick a category. AI agents: run this on your own when a hypertask command fails unexpectedly. Never include task, board or comment content.

Usage: hypertask feedback [note] [options]

Options:
  --category <value>
      Feedback category: call_failed, empty_result, unexpected_result, auth_failed, slow, user_reported_broken, other (default: other)
  --tool <command name>
      Hypertask command that failed
  --status <http status>
      HTTP status from 100 to 599
  --error-code <slug>
      Error code slug
  --error <message>
      Accepted for compatibility; free text is not stored
  --surface <cli|agent>
      Feedback surface (default: cli)
  --json
      Print the raw JSON response

Example:
  hypertask feedback --category <value>

  -h, --help
      Show help

`hypertask fields`

Manage custom fields (Number/Text/Select/Date) on a project's tasks

Usage: hypertask fields <command>

Commands:
  list
      List custom fields defined on a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  create
      Create a custom field on a project (idempotent by name)
  set
      Set a custom field's value on a task (auto-creates the field if missing)
  get
      Print a task's custom field values
  delete
      Delete a custom field (and all its values) — by --field-id, or --project + --name

Example:
  hypertask fields list --project <id>

  -h, --help
      Show help

`hypertask fields create`

Create a custom field on a project (idempotent by name)

Usage: hypertask fields create [options]

Options:
  --project <id> (required)
      Project ID
  --name <name> (required)
      Field name
  --type <type>
      Field type
  --options <json>
      JSON array of choices for --type Select, e.g. '["Low","Medium","High"]'

Example:
  hypertask fields create --project <id> --name <name>

  -h, --help
      Show help

`hypertask fields delete`

Delete a custom field (and all its values) — by --field-id, or --project + --name

Usage: hypertask fields delete [options]

Options:
  --field-id <uuid>
      Field ID
  --project <id>
      Project ID (with --name, resolves the field id via list)
  --name <name>
      Field name (with --project, resolves the field id via list)

Example:
  hypertask fields delete --field-id <uuid>

  -h, --help
      Show help

`hypertask fields get`

Print a task's custom field values

Usage: hypertask fields get <ticket>

Example:
  hypertask fields get <ticket>

  -h, --help
      Show help

`hypertask fields list`

List custom fields defined on a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask fields list [options]

Options:
  --project <id> (required)
      Project ID

Example:
  hypertask fields list --project <id>

  -h, --help
      Show help

`hypertask fields set`

Set a custom field's value on a task (auto-creates the field if missing)

Usage: hypertask fields set <ticket-or-task-id> [options]

Options:
  --name <name> (required)
      Field name
  --value <value> (required)
      Field value

Example:
  hypertask fields set <ticket-or-task-id> --name <name> --value <value>

  -h, --help
      Show help

`hypertask inbox`

Manage notifications

Usage: hypertask inbox <command>

Commands:
  list
      List notifications. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  composition
      Show counts describing one board's inbox load
  archive
      Archive notifications
  unarchive
      Restore archived notifications to the inbox

Example:
  hypertask inbox list

  -h, --help
      Show help

`hypertask inbox archive`

Archive notifications

Usage: hypertask inbox archive <ids...>

Example:
  hypertask inbox archive <ids...>

  -h, --help
      Show help

`hypertask inbox composition`

Show counts describing one board's inbox load

Usage: hypertask inbox composition [options]

Options:
  --project <id> (required)
      Project ID

Example:
  hypertask inbox composition --project <id>

  -h, --help
      Show help

`hypertask inbox list`

List notifications. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask inbox list

Example:
  hypertask inbox list

  -h, --help
      Show help

`hypertask inbox unarchive`

Restore archived notifications to the inbox

Usage: hypertask inbox unarchive <ids...>

Example:
  hypertask inbox unarchive <ids...>

  -h, --help
      Show help

`hypertask labels`

Manage project labels

Usage: hypertask labels <command>

Commands:
  list
      List available labels for a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  create
      Create a new label in a project

Example:
  hypertask labels list --project <id>

  -h, --help
      Show help

`hypertask labels create`

Create a new label in a project

Usage: hypertask labels create [options]

Options:
  --project <id> (required)
      Project ID
  --name <name> (required)
      Label name
  --color <hex>
      Label color

Example:
  hypertask labels create --project <id> --name <name>

  -h, --help
      Show help

`hypertask labels list`

List available labels for a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask labels list [options]

Options:
  --project <id> (required)
      Project ID
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --limit <n>
      Maximum rows to return
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask labels list --project <id>

  -h, --help
      Show help

`hypertask login`

Login to HyperTask via browser

Usage: hypertask login [options]

Options:
  --token <jwt>
      JWT token (skip browser auth)
  --api-url <url>
      API URL

Example:
  hypertask login --token <jwt>

  -h, --help
      Show help

`hypertask logout`

Logout from HyperTask

Usage: hypertask logout

Example:
  hypertask logout

  -h, --help
      Show help

`hypertask messages`

Poll messages addressed to the authenticated identity

Usage: hypertask messages <command>

Commands:
  poll
      Return addressed notifications and the next cursor

Example:
  hypertask messages poll --since <notification-id>

  -h, --help
      Show help

`hypertask messages poll`

Return addressed notifications and the next cursor

Usage: hypertask messages poll [options]

Options:
  --since <notification-id>
      Return notification IDs greater than this cursor

Example:
  hypertask messages poll --since <notification-id>

  -h, --help
      Show help

`hypertask pages`

Manage task pages

Usage: hypertask pages <command>

Commands:
  create
      Create a page
  get
      Get a page
  append
      Append content to a page; keep the existing content type unless --canvas, --html or --markdown is passed
  update
      Update a page; keep the existing content type unless --canvas, --html or --markdown is passed
  list
      List pages by task or project
  archive
      Archive a page (soft delete)
  history
      List a page's saved versions
  restore
      Restore a page from a saved version
  search
      Search pages

Example:
  hypertask pages create --task <id-or-ticket> --title <title>

  -h, --help
      Show help

`hypertask pages append`

Append content to a page; keep the existing content type unless --canvas, --html or --markdown is passed

Usage: hypertask pages append <id> [options]

Options:
  --content <content>
      Content to append
  --markdown-file <path>
      Read content to append from a file
  --html
      Treat content as HTML
  --canvas
      Treat content as an HTML canvas page (html_canvas)
  --markdown
      Treat content as Markdown (explicitly change the page type)

Example:
  hypertask pages append <id> --content <content>

  -h, --help
      Show help

`hypertask pages archive`

Archive a page (soft delete)

Usage: hypertask pages archive <id>

Example:
  hypertask pages archive <id>

  -h, --help
      Show help

`hypertask pages create`

Create a page

Usage: hypertask pages create [options]

Options:
  --task <id-or-ticket> (required)
      Task ID or ticket reference
  --title <title> (required)
      Page title
  --content <content>
      Page content
  --markdown-file <path>
      Read page content from a file
  --parent <id>
      Parent page ID
  --html
      Treat content as HTML
  --canvas
      Treat content as an HTML canvas page (html_canvas)

Example:
  hypertask pages create --task <id-or-ticket> --title <title>

  -h, --help
      Show help

`hypertask pages get`

Get a page

Usage: hypertask pages get <id> [options]

Options:
  --format <markdown|html>
      Content format

Example:
  hypertask pages get <id> --format <markdown|html>

  -h, --help
      Show help

`hypertask pages history`

List a page's saved versions

Usage: hypertask pages history <id>

Example:
  hypertask pages history <id>

  -h, --help
      Show help

`hypertask pages list`

List pages by task or project

Usage: hypertask pages list [options]

Options:
  --task <id-or-ticket>
      Task ID or ticket reference
  --project <id>
      Project ID

Example:
  hypertask pages list --task <id-or-ticket>

  -h, --help
      Show help

`hypertask pages restore`

Restore a page from a saved version

Usage: hypertask pages restore <id> [options]

Options:
  --version <id> (required)
      Page version ID

Example:
  hypertask pages restore <id> --version <id>

  -h, --help
      Show help

`hypertask pages search`

Search pages

Usage: hypertask pages search <query>

Example:
  hypertask pages search <query>

  -h, --help
      Show help

`hypertask pages update`

Update a page; keep the existing content type unless --canvas, --html or --markdown is passed

Usage: hypertask pages update <id> [options]

Options:
  --title <title>
      New page title
  --content <content>
      New page content
  --markdown-file <path>
      Read new page content from a file
  --mode <replace|append|prepend>
      Update mode
  --if-version <n>
      Only update this page version
  --note <text>
      Update note
  --html
      Treat content as HTML
  --canvas
      Treat content as an HTML canvas page (html_canvas)
  --markdown
      Treat content as Markdown (explicitly change the page type)

Example:
  hypertask pages update <id> --title <title>

  -h, --help
      Show help

`hypertask presence`

Show agent presence for a team

Usage: hypertask presence <team-id>

Example:
  hypertask presence <team-id>

  -h, --help
      Show help

`hypertask project`

Manage projects/boards

Usage: hypertask project <command>

Commands:
  list
      List all projects. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  show
      Show project metadata, ticket prefix, sections, and labels. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  update
      Rename a project/board
  manifest
      Show a project's ordered columns and transition policy
  playbook
      Show or replace a project's working rules and definition of done
  instructions
      Show or set a project's custom AI instructions
  members
      List project members. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  sections
      List sections in a project (alias: section list --project <id>). Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  invite
      Invite user/agent to the board
  labels
      List available labels for a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  label
      Manage labels
  archive
      Archive a board you own (use --restore to put it back)
  delete
      Permanently delete a board and all its tasks. Requires board owner or admin access and --yes.
  create-board
      Create a board. Flags: --title <t> --team <id> [--sections a,b,c]. Or a JSON manifest via --manifest <file>/--stdin (team_id, title, sections[], optional labels[], tasks[]).

Example:
  hypertask project list --limit <n>

  -h, --help
      Show help

`hypertask project archive`

Archive a board you own (use --restore to put it back)

Usage: hypertask project archive <id> [options]

Options:
  --restore
      Restore an archived board instead

Example:
  hypertask project archive <id> --restore

  -h, --help
      Show help

`hypertask project create-board`

Create a board. Flags: --title <t> --team <id> [--sections a,b,c]. Or a JSON manifest via --manifest <file>/--stdin (team_id, title, sections[], optional labels[], tasks[]).

Usage: hypertask project create-board [options]

Options:
  --title <title>
      Board title (flag mode)
  --team <id>
      Team/workspace id the board belongs to (flag mode)
  --sections <list>
      Comma-separated column names (default: To Do,In Progress,Done)
  --description <text>
      Board description (flag mode)
  --labels <list>
      Comma-separated label names (flag mode)
  --manifest <path>
      Path to JSON manifest file
  --stdin
      Read JSON from stdin (pipe a file: cat manifest.json | hypertask project create-board --stdin)

Example:
  hypertask project create-board --title <title>

  -h, --help
      Show help

`hypertask project delete`

Permanently delete a board and all its tasks. Requires board owner or admin access and --yes.

Usage: hypertask project delete <id> [options]

Options:
  --yes (required)
      Confirm permanent board deletion

Example:
  hypertask project delete <id> --yes

  -h, --help
      Show help

`hypertask project instructions`

Show or set a project's custom AI instructions

Usage: hypertask project instructions <project-id> [options]

Options:
  --text <text>
      Replace the custom AI instructions (empty clears them)
  --model <model-option-id>
      AI model option ID; only valid with --text

Example:
  hypertask project instructions <project-id> --text <text>

  -h, --help
      Show help

`hypertask project invite`

Invite user/agent to the board

Usage: hypertask project invite <project-id> [options]

Options:
  --user <id|email|agent-uuid>
      User id, email, or managed-agent UUID

Example:
  hypertask project invite <project-id> --user <id|email|agent-uuid>

  -h, --help
      Show help

`hypertask project label`

Manage labels

Usage: hypertask project label <command>

Commands:
  create
      Create a new label in a project

Example:
  hypertask project label create --project <id> --name <name>

  -h, --help
      Show help

`hypertask project label create`

Create a new label in a project

Usage: hypertask project label create [options]

Options:
  --project <id> (required)
      Project ID
  --name <name> (required)
      Label name
  --color <hex>
      Label color

Example:
  hypertask project label create --project <id> --name <name>

  -h, --help
      Show help

`hypertask project labels`

List available labels for a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask project labels <project-id>

Example:
  hypertask project labels <project-id>

  -h, --help
      Show help

`hypertask project list`

List all projects. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask project list [options]

Options:
  --limit <n>
      Results per page
  --offset <n>
      Pagination offset
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask project list --limit <n>

  -h, --help
      Show help

`hypertask project manifest`

Show a project's ordered columns and transition policy

Usage: hypertask project manifest <project-id>

Example:
  hypertask project manifest <project-id>

  -h, --help
      Show help

`hypertask project members`

List project members. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask project members <project-id>

Example:
  hypertask project members <project-id>

  -h, --help
      Show help

`hypertask project playbook`

Show or replace a project's working rules and definition of done

Usage: hypertask project playbook <project-id> [options]

Options:
  --done <rule>
      Definition-of-done rule (repeatable; setting replaces the complete playbook)
  --working-rules <text>
      Working rules (setting replaces the complete playbook)
  --notes <text>
      Notes (setting replaces the complete playbook)
  --clear
      Clear the complete playbook

Example:
  hypertask project playbook <project-id> --done <rule>

  -h, --help
      Show help

`hypertask project sections`

List sections in a project (alias: section list --project <id>). Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask project sections <project-id>

Example:
  hypertask project sections <project-id>

  -h, --help
      Show help

`hypertask project show`

Show project metadata, ticket prefix, sections, and labels. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask project show <project-id>

Example:
  hypertask project show <project-id>

  -h, --help
      Show help

`hypertask project update`

Rename a project/board

Usage: hypertask project update <project-id> [options]

Options:
  --title <title> (required)
      New project/board title

Example:
  hypertask project update <project-id> --title <title>

  -h, --help
      Show help

`hypertask report`

Manage saved board reports

Usage: hypertask report <command>

Commands:
  list
      List saved reports on a board
  get
      Get a saved report including its HTML body
  create
      Create a saved report
  update
      Update selected fields on a saved report
  delete
      Permanently delete a saved report

Example:
  hypertask report list --project <id>

  -h, --help
      Show help

`hypertask report create`

Create a saved report

Usage: hypertask report create <slug> [options]

Options:
  --project <id> (required)
      Project ID
  --title <title> (required)
      Report title
  --description <text>
      Report description
  --body <html>
      Report HTML body
  --html-file <path>
      Read report HTML body from a file

Example:
  hypertask report create <slug> --project <id> --title <title>

  -h, --help
      Show help

`hypertask report delete`

Permanently delete a saved report

Usage: hypertask report delete <slug> [options]

Options:
  --project <id> (required)
      Project ID
  --confirm
      Confirm permanent deletion

Example:
  hypertask report delete <slug> --project <id>

  -h, --help
      Show help

`hypertask report get`

Get a saved report including its HTML body

Usage: hypertask report get <slug> [options]

Options:
  --project <id> (required)
      Project ID

Example:
  hypertask report get <slug> --project <id>

  -h, --help
      Show help

`hypertask report list`

List saved reports on a board

Usage: hypertask report list [options]

Options:
  --project <id> (required)
      Project ID

Example:
  hypertask report list --project <id>

  -h, --help
      Show help

`hypertask report update`

Update selected fields on a saved report

Usage: hypertask report update <slug> [options]

Options:
  --project <id> (required)
      Project ID
  --title <title>
      New report title
  --description <text>
      New report description
  --clear-description
      Clear the report description
  --body <html>
      New report HTML body
  --html-file <path>
      Read new report HTML body from a file

Example:
  hypertask report update <slug> --project <id>

  -h, --help
      Show help

`hypertask search`

Search tasks. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask search <query> [options]

Options:
  --project <id>
      Project ID
  --limit <n>
      Max results
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask search <query> --project <id>

  -h, --help
      Show help

`hypertask section`

Manage sections/columns

Usage: hypertask section <command>

Commands:
  list
      List sections in a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  create
      Create a new section in a project
  rename
      Rename a section in the project
  reorder
      Move a section after another section in the project
  done
      Mark a column as finished: reports count its tickets as completed, Inbox Zero clears them, agents stop treating them as blocking
  update
      Set or clear a column's auto-assign rule
  delete
      Delete a section in the project

Example:
  hypertask section list --project <id>

  -h, --help
      Show help

`hypertask section create`

Create a new section in a project

Usage: hypertask section create [options]

Options:
  --project <id> (required)
      Project ID
  --title <name> (required)
      Section title (e.g. "Backlog", "In Review")
  --after <id>
      Place new section after this section ID

Example:
  hypertask section create --project <id> --title <name>

  -h, --help
      Show help

`hypertask section delete`

Delete a section in the project

Usage: hypertask section delete [options]

Options:
  --project <id> (required)
      Project ID
  --section <id> (required)
      Section ID

Example:
  hypertask section delete --project <id> --section <id>

  -h, --help
      Show help

`hypertask section done`

Mark a column as finished: reports count its tickets as completed, Inbox Zero clears them, agents stop treating them as blocking

Usage: hypertask section done [options]

Options:
  --project <id> (required)
      Project ID
  --section <id|name> (required)
      Section ID or name
  --off
      Mark the column as NOT finished
  --clear
      Remove the setting and fall back to guessing from the column name

Example:
  hypertask section done --project <id> --section <id|name>

  -h, --help
      Show help

`hypertask section list`

List sections in a project. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask section list [options]

Options:
  --project <id> (required)
      Project ID
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --limit <n>
      Maximum rows to return
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask section list --project <id>

  -h, --help
      Show help

`hypertask section rename`

Rename a section in the project

Usage: hypertask section rename [options]

Options:
  --project <id> (required)
      Project ID
  --section <id> (required)
      Section ID
  --title <name> (required)
      Section title (e.g. "Backlog", "In Review")

Example:
  hypertask section rename --project <id> --section <id> --title <name>

  -h, --help
      Show help

`hypertask section reorder`

Move a section after another section in the project

Usage: hypertask section reorder [options]

Options:
  --project <id> (required)
      Project ID
  --section <id|name> (required)
      Section ID or name
  --after <id|name> (required)
      Section ID or name to place this section after

Example:
  hypertask section reorder --project <id> --section <id|name> --after <id|name>

  -h, --help
      Show help

`hypertask section update`

Set or clear a column's auto-assign rule

Usage: hypertask section update [options]

Options:
  --project <id> (required)
      Project ID
  --section <id|name> (required)
      Section ID or name
  --auto-assign <id|none> (required)
      Numeric user ID, agent UUID, or none to clear

Example:
  hypertask section update --project <id> --section <id|name> --auto-assign <id|none>

  -h, --help
      Show help

`hypertask skills`

Manage personal and project skills

Usage: hypertask skills <command>

Commands:
  list
      List personal or project skills. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  get
      Get a skill. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  create
      Create a personal or project skill
  update
      Update a skill
  delete
      Delete a skill
  import
      Import skills from GitHub

Example:
  hypertask skills list --project <id>

  -h, --help
      Show help

`hypertask skills create`

Create a personal or project skill

Usage: hypertask skills create [options]

Options:
  --name <name>
      Skill name
  --slug <slug>
      Skill invocation slug
  --body <body>
      Skill instruction body
  --description <description>
      Skill description
  --argument-hint <hint>
      Skill argument hint
  --scope <user|project>
      Skill scope
  --project <id>
      Project ID (required for project scope)
  --markdown <path>
      Read complete skill content from a SKILL.md file
  --disabled
      Create the skill disabled

Example:
  hypertask skills create --name <name>

  -h, --help
      Show help

`hypertask skills delete`

Delete a skill

Usage: hypertask skills delete <id>

Example:
  hypertask skills delete <id>

  -h, --help
      Show help

`hypertask skills get`

Get a skill. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask skills get <id>

Example:
  hypertask skills get <id>

  -h, --help
      Show help

`hypertask skills import`

Import skills from GitHub

Usage: hypertask skills import <github-url> [options]

Options:
  --scope <user|project>
      Skill scope
  --project <id>
      Project ID (required for project scope)
  --dry-run
      Preview skills without importing them
  --slugs <comma-separated>
      Only import these comma-separated skill slugs

Example:
  hypertask skills import <github-url> --scope <user|project>

  -h, --help
      Show help

`hypertask skills list`

List personal or project skills. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask skills list [options]

Options:
  --project <id>
      Project ID (omit for personal skills)

Example:
  hypertask skills list --project <id>

  -h, --help
      Show help

`hypertask skills update`

Update a skill

Usage: hypertask skills update <id> [options]

Options:
  --name <name>
      New skill name
  --slug <slug>
      New skill invocation slug
  --body <body>
      New skill instruction body
  --description <description>
      New skill description
  --argument-hint <hint>
      New skill argument hint
  --enabled
      Enable the skill
  --disabled
      Disable the skill
  --markdown <path>
      Read complete updated skill content from a SKILL.md file

Example:
  hypertask skills update <id> --name <name>

  -h, --help
      Show help

`hypertask status`

Check authentication status

Usage: hypertask status

Example:
  hypertask status

  -h, --help
      Show help

`hypertask task`

Manage tasks

Usage: hypertask task <command>

Commands:
  list
      List tasks with filters. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  next
      List the highest-priority unleased tasks in a project
  get
      Get task details. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  description-history
      List a task's saved description versions
  description-restore
      Restore a task description from a saved version
  context
      Get a read-only task context pack for agent sessions
  tree
      Show full parent/subtask hierarchy for a task
  link
      Link two tasks by numeric ID or ticket number
  unlink
      Remove the relation between two tasks by numeric ID or ticket number
  relations
      List relations for a task
  related
      Find semantically related tasks
  create
      Create a new task
  update
      Update a task
  assign
      Assign a user or agent to a task (idempotent: repeat assign is a no-op)
  move-to-inbox
      Route a task into a project member's inbox (like the palette action)
  unassign
      Remove a user or agent from task assignees (use --all with --project to clear one assignee across the board)
  move
      Move task: use ticket + --section for same board, or numeric task id + --to for another project
  move-board
      Move task to a different project/board (first arg = numeric task id)
  search
      Search tasks. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Example:
  hypertask task list --project <id>

  -h, --help
      Show help

`hypertask task assign`

Assign a user or agent to a task (idempotent: repeat assign is a no-op)

Usage: hypertask task assign <ticket> [options]

Options:
  --assignee <id>
      Numeric user ID, or agent UUID from `projects members <id>`
  --self
      Assign the calling agent to the task (agent token only, no --assignee needed)

Example:
  hypertask task assign <ticket> --assignee <id>

  -h, --help
      Show help

`hypertask task context`

Get a read-only task context pack for agent sessions

Usage: hypertask task context <ticket-or-id> [options]

Options:
  --project <id>
      Expected project ID (guards against mismatches)
  --summary
      Return a shorter recent-comment subset

Example:
  hypertask task context <ticket-or-id> --project <id>

  -h, --help
      Show help

`hypertask task create`

Create a new task

Usage: hypertask task create [options]

Options:
  --project <id> (required)
      Project ID
  --title <text> (required)
      Task title
  --description <text>
      Comments and descriptions are HTML. Wrap content in block tags. Never embed images; attach files with --attach. Bare text is wrapped in paragraphs.
  --description-file <path>
      Read task description from a local file instead of --description (takes precedence if both given)
  --markdown
      Send the description unchanged for server-side Markdown conversion
  --priority <p>
      Priority: urgent, high, medium, low, none
  --estimate <n>
      Size index: 0 = none, 2-6 = XS,S,M,L,XL
  --labels <list>
      Comma-separated label names or IDs (repeatable; e.g. "CLI,BUG")
  --due <date>
      Due date (ISO 8601)
  --parent-task <ref>
      Parent task: internal id or ticket ref (e.g. HTPR-4578)
  --section <id|name>
      Section ID or name (e.g. 4005 or "Doing")
  --assignee <list>
      Comma-separated user IDs (e.g. "123" or "123,456,789")
  --attach <path-or-url>
      Attach local file or http(s) URL after task is created (repeatable)

Example:
  hypertask task create --project <id> --title <text>

  -h, --help
      Show help

`hypertask task description-history`

List a task's saved description versions

Usage: hypertask task description-history <ticket-or-id>

Example:
  hypertask task description-history <ticket-or-id>

  -h, --help
      Show help

`hypertask task description-restore`

Restore a task description from a saved version

Usage: hypertask task description-restore <ticket-or-id> [options]

Options:
  --version <id> (required)
      Description version ID

Example:
  hypertask task description-restore <ticket-or-id> --version <id>

  -h, --help
      Show help

`hypertask task get`

Get task details. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask task get <ticket-or-task-id> [options]

Options:
  --project <id>
      Project ID; treats a numeric task reference as its board index

Example:
  hypertask task get <ticket-or-task-id> --project <id>

  -h, --help
      Show help

`hypertask task link`

Link two tasks by numeric ID or ticket number

Usage: hypertask task link <source> <target> [options]

Options:
  --type <type>
      Relation type

Example:
  hypertask task link <source> <target> --type <type>

  -h, --help
      Show help

`hypertask task list`

List tasks with filters. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask task list [options]

Options:
  --project <id>
      Project ID
  --search <query>
      Search tasks by keyword instead of listing. When set, only --project scoping is applied; other list filters are ignored.
  --section <id|name>
      Section column ID or name (name requires --project)
  --assigned-to <value>
      Assignee (me, unassigned, or user ID)
  --created-by <id>
      Creator user ID (numeric; server-side filter)
  --priority <list>
      Comma-separated priorities: urgent,high,medium,low
  --labels <list>
      Comma-separated label names or IDs (names need --project)
  --label <list>
      Comma-separated label names or IDs (names need --project)
  --sort-by <field>
      Sort tasks by: createdAt, updatedAt, dueDate, priority, title
  --sort-order <asc|desc>
      Set the sort order of results by asc or desc
  --limit <n>
      Results per page
  --offset <n>
      Pagination offset
  --status <field>
      Filter tasks by status (Normal, Archive, Deleted)
  --has-due-date
      Only tasks that have a due date set
  --query <text>
      Free-text search
  --filter <key=value>
      Structured filter (repeatable). Keys: section, label, assignee, status, updated_since, has_pr
  --sort <field>
      Sort as field or field:asc|desc
  --fields <names>
      Comma-separated projection, for example title,url
  --cursor <token>
      Opaque cursor from the previous page

Example:
  hypertask task list --project <id>

  -h, --help
      Show help

`hypertask task move`

Move task: use ticket + --section for same board, or numeric task id + --to for another project

Usage: hypertask task move <ticket-or-task-id> [options]

Options:
  --section <name>
      Destination section name within same board (e.g. "Doing", "Done")
  --to <id>
      Target project ID — cross-board move (first arg must be numeric task id)
  --to-section <id>
      Target section ID in destination project (use with --to)

Example:
  hypertask task move <ticket-or-task-id> --section <name>

  -h, --help
      Show help

`hypertask task move-board`

Move task to a different project/board (first arg = numeric task id)

Usage: hypertask task move-board <task-id> [options]

Options:
  --target-project <id> (required)
      Target project ID
  --target-section <id>
      Target section ID

Example:
  hypertask task move-board <task-id> --target-project <id>

  -h, --help
      Show help

`hypertask task move-to-inbox`

Route a task into a project member's inbox (like the palette action)

Usage: hypertask task move-to-inbox <ticket> [options]

Options:
  --user <id> (required)
      Recipient user ID (must be a member of the task's project)

Example:
  hypertask task move-to-inbox <ticket> --user <id>

  -h, --help
      Show help

`hypertask task next`

List the highest-priority unleased tasks in a project

Usage: hypertask task next [options]

Options:
  --project <id>
      Project ID
  --label <value>
      Label name or ID filter

Example:
  hypertask task next --project <id>

  -h, --help
      Show help

`hypertask task related`

Find semantically related tasks

Usage: hypertask task related <ticket-or-id>

Example:
  hypertask task related <ticket-or-id>

  -h, --help
      Show help

`hypertask task relations`

List relations for a task

Usage: hypertask task relations <ticket-or-id>

Example:
  hypertask task relations <ticket-or-id>

  -h, --help
      Show help

`hypertask task search`

Search tasks. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask task search <query> [options]

Options:
  --project <id>
      Project ID
  --limit <n>
      Max results

Example:
  hypertask task search <query> --project <id>

  -h, --help
      Show help

`hypertask task tree`

Show full parent/subtask hierarchy for a task

Usage: hypertask task tree [options]

Options:
  --ticket <ticket>
      Ticket number (e.g. HTPR-15)
  --task-id <id>
      Numeric task ID
  --depth <n>
      Max levels deep to show (default: full tree)

Example:
  hypertask task tree --ticket <ticket>

  -h, --help
      Show help

`hypertask task unassign`

Remove a user or agent from task assignees (use --all with --project to clear one assignee across the board)

Usage: hypertask task unassign [ticket] [options]

Options:
  --assignee <id>
      Numeric user ID (removes every row shown under that user in `tasks get`, including agent-linked rows) or agent UUID from `projects members <id>`
  --self
      Unassign the calling agent
  --project <id>
      Project ID (required with --all; with a numeric ticket, prefers board index then falls back to list id)
  --all
      Unassign the chosen person from every Normal, Archive, and Deleted task on --project

Example:
  hypertask task unassign --assignee <id>

  -h, --help
      Show help

`hypertask task unlink`

Remove the relation between two tasks by numeric ID or ticket number

Usage: hypertask task unlink <source> <target>

Example:
  hypertask task unlink <source> <target>

  -h, --help
      Show help

`hypertask task update`

Update a task

Usage: hypertask task update <ticket-or-task-id> [options]

Options:
  --title <text>
      New title
  --description <text>
      Comments and descriptions are HTML. Wrap content in block tags. Never embed images; attach files with --attach. Bare text is wrapped in paragraphs.
  --description-file <path>
      Read new description from a local file instead of --description (takes precedence if both given)
  --markdown
      Send the description unchanged for server-side Markdown conversion
  --pull-request <url>
      Link a GitHub pull request to the task
  --priority <p>
      New priority
  --estimate <n>
      Size index: 0 = none, 2-6 = XS,S,M,L,XL
  --due <date>
      New due date
  --clear-due
      Remove the task's due date
  --status <s>
      New status: Normal, Archive, Deleted
  --section <id|name>
      Section ID or name (e.g. 4005 or "Doing")
  --project <id>
      Project ID; treats a numeric task reference as its board index
  --assignee <list>
      Comma-separated user IDs (e.g. "123" or "123,456,789"). An empty value clears every assignee.
  --clear-assignees
      Remove every assignee from the task
  --labels <list>
      Replace the ticket's entire label set. Repeatable/comma-separated for this call only. Does not append. Use --add-label to keep existing labels.
  --add-labels <list>
      Comma-separated label names or IDs to add, keeping existing labels (repeatable; e.g. "QA")
  --add-label <list>
      Alias of --add-labels. Add labels without dropping the ones already on the ticket (repeatable).
  --remove-labels <list>
      Comma-separated label names or IDs to remove, keeping other labels (repeatable)
  --remove-label <list>
      Alias of --remove-labels. Remove labels without dropping the ones you did not name (repeatable).
  --parent-task <ref>
      Parent task: internal id or ticket ref (e.g. HTPR-4578)
  --clear-parent
      Detach this task from its parent
  --attach <path>
      Attach local file to task after update (repeatable)

Example:
  hypertask task update <ticket-or-task-id> --title <text>

  -h, --help
      Show help

`hypertask teams`

Discover teams and their IDs

Usage: hypertask teams <command>

Commands:
  list
      List teams available to the current user

Example:
  hypertask teams list

  -h, --help
      Show help

`hypertask teams list`

List teams available to the current user

Usage: hypertask teams list

Example:
  hypertask teams list

  -h, --help
      Show help

`hypertask time`

Track time

Usage: hypertask time <command>

Commands:
  start
      Start tracking time for a task
  stop
      Stop tracking time for a task
  pause
      Pause the running timer for a task
  resume
      Resume the paused timer for a task
  status
      Show time-tracking status for a task
  log
      Log time with optional note/date, or subtract from your latest completed entry with negative minutes (no metadata)
  update
      Update a completed time entry; provide at least one of --minutes, --date or --note
  delete
      Delete a time entry
  running
      List running timers
  report
      Show a time report

Example:
  hypertask time start <task>

  -h, --help
      Show help

`hypertask time delete`

Delete a time entry

Usage: hypertask time delete <entry-id>

Example:
  hypertask time delete <entry-id>

  -h, --help
      Show help

`hypertask time log`

Log time with optional note/date, or subtract from your latest completed entry with negative minutes (no metadata)

Usage: hypertask time log <task> <minutes> [options]

Options:
  --date <YYYY-MM-DD>
      Move the entry to a local calendar date
  --timezone-offset-minutes <n>
      Timezone offset used with --date
  --note <text>
      Note for the new entry

Example:
  hypertask time log <task> <minutes> --date <YYYY-MM-DD>

  -h, --help
      Show help

`hypertask time pause`

Pause the running timer for a task

Usage: hypertask time pause <task>

Example:
  hypertask time pause <task>

  -h, --help
      Show help

`hypertask time report`

Show a time report

Usage: hypertask time report [options]

Options:
  --board <id>
      Filter by board
  --task <id>
      Filter by task
  --user <id|me>
      Filter by numeric user id or "me"
  --from <date>
      Filter from date
  --to <date>
      Filter to date
  --running
      Only include running timers

Example:
  hypertask time report --board <id>

  -h, --help
      Show help

`hypertask time resume`

Resume the paused timer for a task

Usage: hypertask time resume <task>

Example:
  hypertask time resume <task>

  -h, --help
      Show help

`hypertask time running`

List running timers

Usage: hypertask time running

Example:
  hypertask time running

  -h, --help
      Show help

`hypertask time start`

Start tracking time for a task

Usage: hypertask time start <task>

Example:
  hypertask time start <task>

  -h, --help
      Show help

`hypertask time status`

Show time-tracking status for a task

Usage: hypertask time status <task>

Example:
  hypertask time status <task>

  -h, --help
      Show help

`hypertask time stop`

Stop tracking time for a task

Usage: hypertask time stop <task>

Example:
  hypertask time stop <task>

  -h, --help
      Show help

`hypertask time update`

Update a completed time entry; provide at least one of --minutes, --date or --note

Usage: hypertask time update <entry-id> [options]

Options:
  --minutes <n>
      Replacement duration in minutes
  --date <YYYY-MM-DD>
      Move the entry to a local calendar date
  --timezone-offset-minutes <n>
      Timezone offset used with --date
  --note <text>
      Replace the entry note

Example:
  hypertask time update <entry-id> --minutes <n>

  -h, --help
      Show help

`hypertask token`

Manage authentication tokens

Usage: hypertask token <command>

Commands:
  refresh
      Refresh the current JWT token
  set-management-key
      Save a management key for agent-management commands

Example:
  hypertask token refresh

  -h, --help
      Show help

`hypertask token refresh`

Refresh the current JWT token

Usage: hypertask token refresh

Example:
  hypertask token refresh

  -h, --help
      Show help

`hypertask token set-management-key`

Save a management key for agent-management commands

Usage: hypertask token set-management-key <key>

Example:
  hypertask token set-management-key <key>

  -h, --help
      Show help

`hypertask update`

Update HyperTask CLI to the latest version

Usage: hypertask update

Example:
  hypertask update

  -h, --help
      Show help

`hypertask user`

Manage user profile

Usage: hypertask user <command>

Commands:
  update
      Update current user profile

Example:
  hypertask user update --name <displayName>

  -h, --help
      Show help

`hypertask user update`

Update current user profile

Usage: hypertask user update [options]

Options:
  --name <displayName>
      Display name
  --photo <url>
      Profile photo URL

Example:
  hypertask user update --name <displayName>

  -h, --help
      Show help

`hypertask view`

Manage views for projects

Usage: hypertask view <command>

Commands:
  list
      List all active views in your projects. If --project is provided, all personal and public views are displayed. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.
  get
      Fetch view details for provided id
  create
      Create a saved filtered view
  update
      Update a saved view
  delete
      Delete a saved view
  switch
      Switch the highlighted board tab to a saved view

Example:
  hypertask view list --project <id>

  -h, --help
      Show help

`hypertask view create`

Create a saved filtered view

Usage: hypertask view create [options]

Options:
  --project <id> (required)
      Project ID
  --title <text> (required)
      View title
  --visibility <value>
      Visibility: Public or Private
  --label <name>
      Filter by label name (repeatable)
  --assignee <userId>
      Filter by assignee: numeric user ID or agent UUID (repeatable)
  --match <mode>
      Filter matching: ALL or ANY
  --sort-mode <mode>
      Sort mode: Manual, Priority, DueDate, Size, CreatedAt, or UpdatedAt
  --sort-order <order>
      Sort order: Ascending or Descending
  --subtasks <mode>
      Subtasks: None=hidden; Parent=parents + count; Flattened=rows; Card=on parent cards; Flattened_Card=rows + cards
  --default
      Set this view as the board default

Example:
  hypertask view create --project <id> --title <text>

  -h, --help
      Show help

`hypertask view delete`

Delete a saved view

Usage: hypertask view delete <viewId>

Example:
  hypertask view delete <viewId>

  -h, --help
      Show help

`hypertask view get`

Fetch view details for provided id

Usage: hypertask view get <id>

Example:
  hypertask view get <id>

  -h, --help
      Show help

`hypertask view list`

List all active views in your projects. If --project is provided, all personal and public views are displayed. Piped output is plain, tab-separated, complete, and machine-readable (no truncation, no color codes) - safe to parse directly without --json.

Usage: hypertask view list [options]

Options:
  --project <id>
      Project ID
  --visibility <value>
      Filter views by 'Public' or 'Private'
  --limit <n>
      Results per page
  --offset <n>
      Pagination offset

Example:
  hypertask view list --project <id>

  -h, --help
      Show help

`hypertask view switch`

Switch the highlighted board tab to a saved view

Usage: hypertask view switch <viewId>

Example:
  hypertask view switch <viewId>

  -h, --help
      Show help

`hypertask view update`

Update a saved view

Usage: hypertask view update <viewId> [options]

Options:
  --title <text>
      New view title
  --visibility <value>
      Visibility: Public or Private
  --label <name>
      Replace label filters (repeatable)
  --assignee <userId>
      Replace assignee filters (repeatable)
  --clear-labels
      Clear all label filters
  --clear-assignees
      Clear all assignee filters
  --match <mode>
      Filter matching: ALL or ANY
  --sort-mode <mode>
      Sort mode: Manual, Priority, DueDate, Size, CreatedAt, or UpdatedAt
  --sort-order <order>
      Sort order: Ascending or Descending
  --subtasks <mode>
      Subtasks: None=hidden; Parent=parents + count; Flattened=rows; Card=on parent cards; Flattened_Card=rows + cards
  --default
      Set this view as the board default

Example:
  hypertask view update <viewId> --title <text>

  -h, --help
      Show help

`hypertask webhook`

Manage signed mention and assignment webhooks for an agent

Usage: hypertask webhook <command>

Commands:
  get
      Show configuration, contract, and recent deliveries
  configure
      Create or update an agent webhook
  test
      Queue a real signed webhook.test delivery
  replay
      Replay one delivery with a new delivery ID
  rotate-secret
      Rotate and print the signing secret once
  delete
      Delete the webhook and delivery history

Example:
  hypertask webhook get --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook configure`

Create or update an agent webhook

Usage: hypertask webhook configure [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token
  --url <https_url>
      Public HTTPS receiver URL
  --project <id>
      Limit delivery to one board
  --all-boards
      Remove the board filter
  --event <name>
      Event name (repeatable)
  --enabled
      Enable delivery
  --disabled
      Disable delivery

Example:
  hypertask webhook configure --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook delete`

Delete the webhook and delivery history

Usage: hypertask webhook delete [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token
  --confirm
      Confirm permanent deletion

Example:
  hypertask webhook delete --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook get`

Show configuration, contract, and recent deliveries

Usage: hypertask webhook get [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask webhook get --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook replay`

Replay one delivery with a new delivery ID

Usage: hypertask webhook replay <delivery-id> [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask webhook replay <delivery-id> --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook rotate-secret`

Rotate and print the signing secret once

Usage: hypertask webhook rotate-secret [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask webhook rotate-secret --agent <agent_id>

  -h, --help
      Show help

`hypertask webhook test`

Queue a real signed webhook.test delivery

Usage: hypertask webhook test [options]

Options:
  --agent <agent_id>
      Owned agent UUID; defaults to self for an agent token

Example:
  hypertask webhook test --agent <agent_id>

  -h, --help
      Show help